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PREFACE 


This document describes the purpose and the use of the ICE-86A In-Circuit 
Emulator for the Intel 8086 microprocessor. 


The ICE-86A module is an optional addition to the Intellec Microcomputer 
Development System. The ICE-86A module aids in testing and modification of the 
hardware and software for new products designed around the 8086 microprocessor. 


Chapter 1 describes the mission of the ICE-86A emulator as a development aid for 
system designs based on Intel’s 1:APX-86 microprocessor. 


Chapter 2 gives step-by-step instructions for installing the ICE-86A hardware in the 
Intellec chassis and connecting the ICE-86A emulator to the user prototype system. 


Chapter 3 presents a hands-on debugging session with the ICE-86A emulator. 


Chapter 4 describes the elements of the ICE-86A command language, the notation, 
conventions, and the syntactic rules used in this manual. 


Chapter 5 defines the operands, operators, and expressions used in the ICE- 86A 
commands. 


Chapter 6 contains discussions and specifications of the emulation and trace control 
commands. 


Chapter 7 contains discussions and specifications of the interrogation _ utility 
commands. 


Chapter 8 contains discussions and specifications of the compound and macro com- 
mands used in the ICE-86A emulator. 


Appendix A is a list of all ICE-86A keywords (literals), and their abbreviations, in 
alphabetical order. 


Appendix Bis a list of ICE-86A error and warning messages with interpretations. 
Appendix C contains a syntactic summary of the ICE-86A commands. 


Appendix D presents the electrical and physical characteristics of the ICE-86A 
emulator. 


Appendix E presents the 8086 assembler instructions in hexadecimal order. 
is oneadix F contains the iSBC 86/12 and iSBC 86/12A fix. 

Appendix G explains the use of the CLOCK, RDY, and RWTIMEOUT. 
Appendix H provides installation procedures for the ICE-86 upgrade. 


Appendix | explains the use of the mane Point Macros with the ICE-86A 
emulator. 


Appendix J contains schematic drawings for reference. 


mi 


To use this manual effectively, you need to understand the 8086 architecture and 
techniques of programming and debugging. The following publications contain | 
detailed information related to this manual: 


ISIS-I User’s Guide | 9800306 


8080/8085 Assembly Language Programming Manual 9800301 
ISIS-1 8080/8085 Macro Assembler Operator’s Manual 9800292 
A Gulde To Intellec Microcomputer Development Systems 9800558 
The 8086 Family User’s Manual 9800722 
8086 Family Utilities Users Guide 9800639 
The 8086 Family User’s Manual Numerics Supplement 121586 
8086/8087/8088 Macro Assembly Language Reference Manual 121623 
8086/8087/8088 Macro Assem bler Operating Instructions 121624 
PL/M-86 User’s Guide 121636 
8089 Real-Time Breakpoint Facility Operating Instructions for 

ICE-86A/88A In-Circuit Emulator Users 162490 


A complete list of publications for use with the Intellec Series III MPEP OCOMIO UIST 
Development System | is provided in the following manual: 


Intellec Series LI Microcomputer Development System Product 
Overview | ; 121575 
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CHAPTER 1 
INTRODUCTION TO THE 


ICE-86A"™ EMULATOR 


This manual presents the operation of the In-Circuit Emulator for the Intel 8086 
microprocessor, or ICE-86A emulator. As an introduction to the use of this 
microprocessor design aid, this chapter contains an overview of the product and its 
relationship to other products and contains a brief discussion of integrated 
hardware/software development, in-circuit emulation, and ICE-86A architecture. 
Also a generalized development cycle with the ICE-86A emulator and a generalized 
ICE-86A emulation session are presented. _ 


ICE-86A In-Circuit Emulator 


The ICE-86A emulator provides in-circuit emulation for 8086 microprocessor-based 
systems. Figure 1-1 shows the functional block diagram of the 8086 CPU. The 
ICE-86A module consists of three circuit boards which reside in the Intellec Micro- 
computer Development System. A cable and buffer box connect the Intellec to the 
user system by replacing the user’s 8086. In this manner the Intellec debug functions 
are extended into the user system. Using the ICE-86A module, the designer can 
execute prototype software in continuous or single-step mode and can substitute 
Intellec equivalents for user devices, such as memory. 


| RELOCATION 
REGISTER REGISTER 
FILE FILE 
(RAX)[ RAH [RAL 
(RBX)|_RBH | RBL_| 
(RCX)[ RCH | RCL | 
(RDX){ RDH | RDL_ | 
BHE/S7 
A16/S3-A19/S6 
, AD15-ADo 
| 16-BIT ALU | INTA, WR, RD 
| = PSW DT/R, DEN, ALE 


INSTRUCTION 
QUEUE 


CONTROL, TIMING. 
RESET ———__—___»} AND STATUS QS0, QS1 
READY —————>| | Siantee aa 
TEST ——___» 6,1, S2 
RQ/GTO ___HOLD CLK __ ss GND-_—s-¢ 5V 
RQ/GTi HLDA MN/MX : 
Figure 1-1. 8086 CPU Functional Block Diagram — 162554-2 
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The 8086 CPU can be used with the 8087 NDP (Numeric Data Processor) and/or 


with the 8089 IOP (Input/Output Processor). The 8087 NDP is capable of expand- 


ing the 8086 CPU’s arithmetic abilities to include floating point calculations. (See 
The 8086 Family User’s Manual Numerics Supplement, Manual Order Number 
121586, for information on the use of the 8087 NDP as a coprocessor.) 


The ICE-86A emulator provides extended capabilities to allow debugging of systems 
using the 8086 CPU with the 8087 NDP. Coprocessor debugging is aided by the 
following ICE-86A features: 


e Three real number types for memory content references 


e Four external buffer box signals to aid in coordinating the user system with the 
ICE-86A emulator 


¢ RQGT and BUS commands for the operation of the 8086 RQGT ies | 
e DASM and DEFINE DASM commands for disassembling 8087 instructions 
e Emulation timer for optimizing coprocessor code 


The 8089 IOP allows for more efficient handling of processor I/O. (See The 8086 
Family User’s Manual, Manual Order Number 9800722, for information on the use 
of the 8089 IOP.) 


The 8089 Real-Time Breakpoint Facility (RBF-89) is a software superset of the 
ICE-86 emulator Version 1.2, a previous 8086 emulator. RBF-89 includes most of 
the ICE-86A features (see below for exceptions) plus the following features that aid 
in designing systems based on an 8086 CPU used with an 8089 IOP: 


e Commands to initialize the 8089 IOP 
e Commands to control program execution on the 8089 IOP 
¢ Commands to disassemble 8089 instructions 


RBF-89 software runs on ICE-86 or ICE-86A hardware but does not include the 
following ICE-86A features: 


e External buffer bus signals are not available. 
° ENABLE/DISABLE SYMBOLICALLY commands are not available. 


e DASM and DEFINE DASM for disassembling 8087 instructions commands are 
not available. 


e ENABLE/DISABLE EXPANSION commands are not available. 
e The SELECTING modifier for the LOAD command is not available. 


e The one-byte CAUSE register is returned raenel than the string associated with 
various conditions. 


e The three real number types (REAL, DREAL, and TREAL) are not available. 


See 8089 Real-Time Breakpoint Facility Operating Instructions for ICE-86A/88A 
In-Circuit Emulator Users, Manual Order Number 162490, for instructions on the 
use of RBF-89. | 


The ICE-86 and ICE-86A Emulators 


The following features are supported in the ICE-86A emulator (Version 2.0), but are 
not included in the ICE-86 emulator (Version 1.2), the premous 8086 emulator: 


© RQGT lines 
e External control of emulation 
¢ A hardware reset signal to ‘the user system 


ICE-86A 


ICE-86A 
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e §6A signal indicating emulation status 

e A signal indicating when a breakpoint condition has been met 
e ENABLE/DISABLE SYMBOLICALLY commands 

¢ RQGT and BUS commands 

e DASM and DEFINE DASM commands 

e ENABLE/DISABLE EXPANSION commands 

e TheSELECTING modifier for the LOAD command 

e A string is returned from the display of the CAUSE register 

e Three real data types (REAL, DREAL, and TREAL) 


ICE-86 emulator (Version 1.2) users consulting this manual for operating instruc- 
tions should note the differences listed above. When reading this manual, ICE-86 
emulator (Version 1.2) users should keep in mind that these enhanced features only 
work with the ICE-86A emulator (Version 2.0). 


Additionally, some users may wish to run the ICE-86A (Version 2.0) software on 
ICE-86 (Version 1.2) hardware, for example, before they have upgraded their 
ICE-86 (Version 1.2) hardware. 


The following features require the ICE-86A hardware and are not supported in a 
configuration using ICE-86 hardware with ICE-86A software: 


¢ RQGT lines 

e External control of emulation break 

e A hardware reset signal for the user system 

e A signal indicating emulation status 

e A signal indicating when a breakpoint condition has been met 
e RQGT and BUS commands | 
¢ DASM and DEFINE DASM commands 


Integrated Hardware/Software Development 


The ICE-86A emulator allows hardware and software development to proceed con- 
currently. This is more effective than the traditional method of independent hard- 
ware and software development followed by a system integration phase. With the 
ICE-86A emulator, prototype hardware can be added to the system as it is designed. 
The software and hardware can be used to test each other as the product is 
developed. 


Conceptually, the ICE-86A emulator can be viewed as assisting three stages of 
development: 


1. The ICE-86A emulator can be operated without being connected to the user’s 
system, so its debugging capabilities can be used to facilitate software develop- 
ment before any of the user’s hardware is available. 


2. To begin integration of software and hardware development efforts, the user’s 
prototype need consist of no more than an 8086 CPU socket. Through ICE-86A 
mapping capabilities, Intellec system equivalents (such as Intellec memory) can 
be substituted for missing prototype hardware. As each section of the user’s 
hardware is completed, it can be added to the prototype, replacing the Intellec 
equivalent. Thus each section of the hardware and software can be ‘‘system’”’ 
tested as it becomes available. 
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3. When the user’s prototype is complete, it can be tested using the system 
software which will drive the final product. The ICE-86A emulator can be used 
for real time emulation of the 8086 to oe the system as a complete unit. 


Thus the ICE-86A emulator provides the user with the ability to debviie a Brateies 
or production system at any stage in its development without introducing extraneous 
hardware or software test tools. 


ICE-86A In-Circuit Emulation 


The ICE-86A In-Circuit Emulator is a diagnostic tool that is used for testing and 
debugging the hardware and software of user-designed 8086 microcomputer-based 
systems. Such testing may begin during the early phases of user system development 
and may continue throughout the life cycle of the user’s system. 


The interface between the in-circuit emulator and the user system is implemented at 
the connector pins of the user system microprocessor chip. These pins carry the 
information that establishes the characteristics and status of the user system. The 
interface makes it possible for the in-circuit emulator to continually monitor user 
Operations and to provide control of these operations. More specifically, the 
in-circuit emulator monitors execution of the user program and controls the condi- 
tions under which the user program execution Is initiated and terminated. 


User Program Execution Control 


Starting and stopping execution of the user program at predefined points or condi- 
tions is an essential task of the in-circuit emulator as it is often not feasible or 
desirable to execute the entire user program. For example, a single routine may be 
executed because either other routines have not yet been coded or because a fault 
(bug) has been isolated to that routine. 


The starting address for execution is readily established by loading a known value 
into the program counter of the user processor while the processor 1s inactive. Ter- 
mination of execution is a more involved procedure which requires the in-circuit 
emulator to halt the processor when a predetermined multi-condition state exists at 
the 8086 pins. This process requires prior storage of state values within the in-circuit 


emulator hardware and dynamic comparison of these values with the states of | 


specified data, address and/or status pins of the processor. The point at which the 
user program execution is terminated is known as the breakpoint. 


A breakpoint may be specified to cause the user program to halt execution when a 
given memory location is addressed during a processor fetch (i.e., loaded into the 
8086 execution queue). However, very often the operator is more interested in the 
data value of a memory location or an I/O port. In the latter cases both the type of 
instruction (read, write, input, or output) and the data value are prespecified and are 
dynamically compared with the processor pin states. It is also possible to specify 
‘*don’t care’? comparisons with the data pins and thereby halt execution whenever 
the designated type of instruction is extracted from the queue for execution. 


A wide range of breakpoint conditions are possible through comparison of the pro- 


cessor chip states with predesignated values. The full range of breakpoint conditions 
| pt may be spepuiey by the operator are presented in subsequent chapters. 


Memory Mapping 


Memory for thé user Sieh can be resident in the user system or ‘‘borrowed’’ from 


the Intellec system through ICE-86A’s mapping capability. 
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The ICE-86A emulator allows 1 megabyte of user memory to be addressed by the 
8086. This user memory space consists of 1024 1K byte segments that can be mapped 
in 1K blocks to: 


1. Physical memory in the user’s system, 

2: Either of two 1K blocks of ICE-86A high speed memory, 
3. Intellec expansion memory, 

4. Arandom access diskette file. 


The first 64K of Intellec RAM memory is dedicated to Intellec system software. 
Therefore the RAM boards within the Intellec system that are used by the ICE-86A 
emulator to store the user program employ effective addresses beyond the 64K byte 
memory accessible to Intellec system software. 


Mapping consists of specifying where each ‘‘logical’? memory block that the 8086 
addresses will physically exist within various physical memories. During emulation 
the memory map is used to determine the existence and physical location of the 
logical memory space being referenced by the user program. 


If a logical segment of addresses is not activated by associating the segment with a 
physical memory, the segment is ‘‘guarded.’’ A guarded segment is logically non- 
existent and any reference to the segment by the user program results in an error. 
Thus the ICE-86A emulator can trap memory accesses outside the intended memory 
for program and data. All blocks are initially guarded following system reset and 
any segment may be guarded on command after its initial activation. 


Mapping enables the user to allocate segments of user memory space to physical 
memories other than the RAM/ROM of the user system. This feature permits 
testing of the user program prior to installation of user memory and also provides a 


convenient means of executing modified code in ‘‘borrowed’’ memory while the 


bulk of user program is resident within the user system. 


Symbolic Debugging 


Symbols and PL/M statement numbers may be substituted for numeric values in 
any of the ICE-86A commands. This allows the user to make symbolic references to 
I/O ports, memory addresses, and data in a user program. Thus the user need not 
search listings for addresses of variables or program subroutines. 


Symbols can be used to reference variables, procedures, program labels, and source 
statements. Thus a variable can be displayed or changed by referring to it by name 
rather than by its absolute location in memory. Using symbols for statement labels, 
program labels, and procedure names allows the user to set breakpoints or disassem- 
ble a section of code into its assembly mnemonics much more easily. 


Furthermore, each symbol may have associated with it one of the types BYTE, 


WORD, INTEGER, SINTEGER (for short, 8-bit integer), POINTER, REAL, © 


DREAL, or TREAL. Thus when the user examines or modifies a variable from the 
source program, he doesn’t need to remember its type. For example, the command 
“!VAR”’ displays the value in memory of variable VAR in a format appropriate to 
its type, while the command ‘‘!VAR = !VAR1”’ assigns the value of VAR1 to VAR. 


The user symbol table generated along with the object file during a PL/M-86 com- 
pilation or by the 8086 Assembler is loaded into the ICE-86A emulator along with 


the user program which is to be emulated. The user may add to this symbol table any 


additional symbolic values for memory addresses, constants, or variables that are 
found to be useful during system debugging. | 
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In addition, the ICE-86A emulator provides access to all the 8086 registers and flags 


through mnemonic reference. The READY, NMI, TEST, HOLD, RESET, INTR, 
and MN/MX pins can also be read. 


Display 


Three basic types of data are available for display: trace data, 8086 termination con- 


ditions, and test parameters. Trace data is collected from the 8086 pins during execu- 
tion of the user program. Trace data collection can be continuous or selective. 
Tracepoints allow the user to selectively turn trace off and on as desired during 
emulation. The tracepoints are stored by the ICE-86A hardware on command prior 
to emulation. If trace data collected exceeds the capacity of the trace buffer, the 
older trace data is overwritten by current data. Trace buffer pointers entered by the 
operator permit selection of the trace information for display. 


The 8086 termination conditions are the status values of the 8086 processor that are 
accessible following termination of user program execution. The 8086 termination 
conditions include the values of registers, flags, input pins, I/O ports, status 
information, and the contents of the logical user memory space locations currently 
activated by the memory map. Some of this information is the same as that collected 
in the trace buffer. All 8086 termination conditions are displayed by console entry of 
the memory or port address or the name of the register, flag, or input pin. 


Hardware resident test parameters are entered by the operator and stored within the 
ICE-86A hardware. Such information includes breakpoints, tracepoints, the 
memory map, and the tracepointer used for control of trace data display. The 
operator displays this information to verify the correct entry or to determine the 
values of test parameters that were previously entered. 


Software resident test parameters are entered by the operator and stored within 
ICE-86A software. These parameters are used to establish values that effect hard- 
ware only upon entry of other commands. For example the symbol manipulation 
commands establish the relationship between the object code of the user program 
and symbols, statement numbers, and module names that are used by the operator 
to reference the user program code and data symbolically. 


Operating Modes 


The ICE-86A software is a development system-based program which provides the 
user with easy-to-use commands for defining breakpoints, initiating emulation, and 
interrogating and altering user status recorded during emulation. The ICE-86A com- 
mands are configured with a broad range of modifiers which provide the user with 
maximum flexibility in describing the operation to be performed. | 


There are two distinct phases of operation when the ICE-86A emulator is used for 
debugging. The interval when the user program is being executed is referred to as the 
emulation phase. The interval when the operator establishes and modifies test 
parameters and displays (or prints) test results is the interrogation phase. 


Emulation 


Emulation commands to the ICE-86A emulator control the process of setting up and 
running an emulation of the user’s program and examining the results of the emula- 


tion. Breakpoints and tracepoints enable the ICE-86A emulator to halt and provide 
a detailed trace in any part of the user’s program. A summary of the emulation com- 


mands is shown in table 1-1. 
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Table 1-1. Summary of ICE-86A™ Emulation Commands 


Initializes emulation and allows the user to specify the 
starting point and breakpoints. Example: 


GO FROM .START TILL. DELAY EXECUTED 

where START and DELAY are statement labels. 

Allows the user to single-step through the program. 
Sets the GO-register to a set of one or more breakpoint 
conditions or causes the display of the current 
GO-register settings. 

ENABLE/DISABLE TRACE Turn trace data collection on or off. 

TRACE Set trace display mode to display trace data in frame or 
instruction format or display current trace display 
mode. 

OLDEST Move trace buffer pointer to top of trace buffer. 


NEWEST Move trace buffer pointer to bottom of trace buffer. 


MOVE Move trace buffer pointer forward or backwards in 
buffer a specified number or buffer entries. 


PRINT Display one or more entries from the trace data buffer. 


CLOCK Specify system clock as internal (ICE emulator 
provided) or external (user-provided) or cause current 
clock setting to be displayed. 


RWTIMEOUT Allows the user to time out READ/WRITE command 
signals based on the time taken by the 8086 to access 
expansion Intellec memory or disk-based memory. 


ENABLE/ DISABLE RDY Allows the user to enable or disable the user-ready 
signal for accessing Intellec resident memory or disk 
memory. 


Breakpoints—the ICE-86A emulator has two breakpoint registers which allow the 
user to halt emulation when a specified condition is met. The breakpoint registers 
may be set up as execution or non-execution breakpoints. An execution breakpoint 
consists of a single address which causes a break whenever the 8086 executes an 
instruction byte which was obtained from that address. A non-execution breakpoint 
causes an emulation break when a specified condition other than an instruction exe- 
cution occurs. This condition can contain up to four parts: 


1. A set of address values, 


2. A particular status of the 8086 bus (one or more of memory or I/O read or 
write, instruction fetch, halt, or interrupt acknowledge), 


3. A set of data values, 


4. A segment register (break occurs when the register is used in an effective address | 
calculation). 


Break on a set of address values has three capabilities: 
1. To break ona single address. 


2. To set any number of breakpoints within a limited range (1024 bytes beginning 
at an even address) of memory. 
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3. To break in an unlimited range. Execution is halted on any memory access to an 
address greater than or equal to (or less than or equal to) the breakpoint. 


An external break input exists at the buffer box. It causes a break when a high to low. 
| transition occurs. An external breakpoint match output for user access is provided 
on the buffer, which allows synchronization of other test equipment when a break 


OcCUrSs. 


Tracepoints—the ICE-86A emulator has two tracepoint registers which establish 


match conditions to conditionally start and stop trace collection. The trace informa- 


tion is gathered at least twice per bus cycle, first when the address signals are valid 
and second when the data signals are valid. Trace information is also collected each 
CPU cycle during which the execution queue is active. 


Each trace frame contains the 20 address/data line values and detailed epemien 
on the status of the 8086. The trace memory can store up to 1023 frames, or an 
average of about 300 bus cycles, of trace data. The trace memory contains the last 
1023 frames of trace data collected, even if this spans several separate emulations. 
The user has the option of displaying each frame of the trace data or displaying by 
instruction in actual 8086 Assembler mnemonics. The trace data is always available 
after an emulation. 


Interrogation and Utility 


Interrogation and utility commands give the user convenient access to detailed 
information about the program and the state of the 8086 which is useful in debug- 
ging hardware and software. Changes can be made in both user program memory 
and the state of the 8086. Commands are also provided for various utility operations 
such as loading and saving program files, defining symbols and macros, setting up 
the memory map, and returning control to ISIS-II. A summary of the basic inter- 
rogation and utility commands is shown in table 1-2. 


During the Interrogation and Utility mode, the ICE-86A emulation processor will 
not respond to an NMI or RESET signal generated by the user system. However, it 
will respond to RQGT and HOLD signals from the user system. 


Table 1-2. Summary of Basic ICE-86A™ Interrogation and Utility Commands 


_Memory/Register Commands | Display or change the contents of: 


Memory 

8086 Registers 

ICE-86A Pseudo-Registers 
8086 Status flags 

8086 Input pins 

8086.1/O ports 


| Memory Mapping Commands | Display, declare, set, or reset the ICE-86A memory 
_ mapping. 


~DASM | Disassembles the memory into 8086 assembler | 


| mnemonics. 


- LOAD | Fetches user symbol table and object code from the 
| input file. 


| SAVE | | Sends user symbol table and object code to the output 


| file. 


LIST | Sends a copy of all output (including prompts, input | 
: | | line echos, and error messages) to the chosen output | 
| device (e.g., disk, printer) as well as the console. 


F EVALUATE | | | Displays the value of an ge rede in binary, octal, 
: | _ | decimal, hexadecimal, and ASCII. 


ICE-86A 


ICE-86A 


| BUS 


CAUSE 


DEFINE DASM 


Symbol Manipulation Commands 


TYPE 


SUFFIX/BASE 
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Table 1-2. (Cont’d.) 


a 


Sets or displays the status of the Request/Grant 
facility which enables the ICE-86A emulator to share 
the system bus with coprocessors. 


Displays which device is currently master of the | 


system bus. 


Displays a mnemonic indicating the cause of the most | 


recent emulation halt. 


Informs the ICE-86A emulator of the configuration of 


the user system; i.e., whether the 8087 chip or the 8087 © 


emulator exists. 
These commands allow the user to: 


Display any or all symbols, program modules, and pro- 


gram line numbers and their associated values (loca- | 


tions in memory). 


Set the domain (choose the particular program 
module) for the line numbers. 


Define new symbols as they are needed in debugging. 


Remove any or all symbols, modules, and program 
statements. 


Change the value or type of any symbol. 
Enable or disable symbolic display. 


Assigns or changes the type of any symbol in the 


: symbol table. 


Establishes the default base for numeric values in 
input text/output display (binary, octal, decimal, or 
hexadecimal). 


. 


Macro and Compound Commands 


The ICE-86A software allows the user to program the operation of the ICE-86A 


hardware by using macros and compound commands. 


A macro consists of a set of ICE-86A commands with up to ten command 
parameters and is typically used to perform any task that is required frequently. 
Commands are provided to define, display, and delete macros, to invoke macros 
with an optional list of arguments, and to save macros in a diskette file or to load 


previously created macros from a diskette file. 


As an example, the following macro may be used to emulate a user program from a 
start address until a breakpoint is encountered, then to continue until a condition is 


satisfied: 
DEFINE MACRO GO 
IP = OFFSET %0 
CS = SEGMENT %0 
REPEAT 
GO TILL %1 
‘DISPLAY 


UNTIL %2__ 
ENDR 


;DISPLACEMENT OF START ADDRESS 
;BASE OF START ADDRESS 


‘EMULATE TO BREAKPOINT 

‘INVOKE MACRO TO DISPLAY 
VARIABLES OF INTEREST 

“CONTINUE UNTIL SOME CONDITION 


‘GO .START, #20 EXECUTED OR .A LEN 10T READ, !FLAG =0 
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The symbols START, A, FLAG, and #20 are from the user program. 


The last line invokes macro GO, causing emulation to begin at label START, to 


_break whenever statement #20 is executed or any element of a 10-byte array A is 


read, and then to continue unless the variable FLAG has a value of zero. 


Compound commands are control structures to either conditionally execute other 


commands (IF), or to execute other commands until some condition is met or the 


commands have been executed a certain number of times (COUNT, REPEAT). 


For example, the following compound command is used to repeat a set of com- 
mands until a condition is met: 


IP = OFFSET .START ;DISPLACEMENT OF START ADDRESS 
CS = SEGMENT .START ;BASE OF START ADDRESS 
REPEAT | 
UNTIL IP = 1000H ;BREAK CONDITION 
STEP SSINGLE STEP 
ENDR 


In this command the condition IP = 1000H is tested every STEP. If the sequence of 
STEPs reaches IP = 1000H, the loop will terminate. 


ICE-86A Architecture 


This section contains a brief description of the software, firmware and hardware 
that compose the ICE-86A emulator. The information serves as an introduction to 
more detailed information presented in the remaining chapters of this manual. 


ICE-86A Software 


The ICE-86A software together with ISIS-II and the user program symbol table is 


resident within the 64K byte memory of the Intellec system. None of this space is 


available to user program code. User program address space mapped to Intellec 


resides in RAM boards (1.e., extended Intellec memory) whose physical addresses 


are above the reserved 64K byte address range. 


The functions performed by the ICE-86A software are dependent on the ICE-86A 


Operating mode. In the interrogation mode, the ICE-86A software provides. 


arithmetic and logical conversions as necessary to establish compatibility between 


the ICE-86A hardware and the operator. This task includes conversion of operator’ 


commands to a form usable by the firmware and the evaluation of symbolic entries 
as necessary to provide absolute address and data values to the hardware. The 
ICE-86A software also reconverts hardware supplied information (trace data, error 
codes, map data, etc.) to forms that are meaningful to the operator. In the emula- 
tion mode, the ICE-86A software supports the accessing of user code from the 
diskette. In this mode the software also terminates emulation when directed by the 
hardware (breakpoint) or the operator (ESCape key). | 


Firmware commands are hardware related commands that are sent to the ICE-86A 
firmware to initiate a specific action. In general, each ICE-86A (operator-entered) 
command is an element of higher level language that is converted to a specific series 
of lower level firmware commands (assuming that the ICE-86A command requires a 
hardware action). Thus, while the ICE-86A LOAD command merely specifies 
loading of a user program into user address space, the actual process requires 
reading of the memory map and writing of the user code into user, ICE, Intellec, or 
diskette memory as indicated by the map. Not only are multiple firmware com- 
mands required but the set of firmware commands issued is dependent on the 
parameters included within the ICE-86A command. 4 
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ICE-86A Firmware 


ICE-86A firmware consists of a 12K-byte ROM-resident program that is executed by 
an 8080 ‘“‘ICE processor’’ of the ICE-86A hardware. The firmware performs three 
major functions. During start-up or system reset, the firmware resets all hardware 
test parameters and performs a series of go/no-go tests to ensure proper operations 
of the ICE-86A hardware. In the interrogation mode, the firmware decodes the 
firmware commands and initiates the specified hardware operations including the 
sequencing of data transfers to and from the ICE-86A software. In the emulation 
mode, the firmware supports user program activities that require use of Intellec 
resources such as the transfer of user code from diskette or extended Intellec 
memory. 


iICE-86A Hardware 


ICE-86A hardware consists of five circuit boards and four cables. Three of the cir- 
cuit boards plug into the Intellec chassis: 


e FM Controller Board 
e 86 Controller Board 
e Trace Board 


Two smaller circuit boards are housed within the ICE-86A buffer box assembly: 
e Buffer Board 1 
e Buffer Board 2 


The buffer box cable assembly interconnects the user hardware and the ICE-86A cir- 
cuit boards within the Intellec chassis. Connection to the user system is made by this 
cable via the 40-pin socket that normally contains the 8086 user processor. When the 
ICE-86A emulator is thus connected to the user system, the functions of the user 
processor are assumed by an 8086 located within the buffer box assembly. The 8086 
in the buffer box assembly is called the user processor within this manual. The buf- 
fer box assembly is located near the user end of this cable assembly. 


*X’ and ‘Y’ cables interconnect the buffer box and two circuit boards in the Intellec 
chassis. The ‘T’ cable provides direct connection between the 86 Controller Board 
and Trace Board. 


A block diagram of the ICE-86A hardware is shown in figure 1-2. 


Buffer Box Signals 


The buffer box has four external signal lines and a ground pin provided to help coor- 
dinate user’s hardware with the ICE-86A emulator. 


These lines are: INITOUT/, EMUL, BRKEXT, and (MATCHO OR MATCH1)/. 
Below is a brief user description of each line; signal characteristics are given in 
Appendix D. See Chapter 2 for installation of cables. 


The INITOUTY line supports an output-only initialization signal that can reset user 
hardware working in conjunction with the 8086 CPU (such as the 8087 Numeric 
Data Processor or the 8089 Input/Output Processor). The signal is issued as part of 
the response to the RESET HARDWARE command (see Chapter 7); the pulse 
width is 550 microseconds and active low. 
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Figure 1-2. ICE-86A™ Functional Block Diagram 162554-3 


The EMUL line carries an active high signal that indicates when the ICE-86A 
emulator is in emulation mode. The signal goes active 4 clock cycles before the first 
instruction fetch in emulation and terminates 7 clock cycles following the last 8086 
cycle emulated. 


The BRKEXT line allows an external signal to break emulation (such a signal may 
come from a coprocessor, a peripheral, etc.). The signal must change from high to 
low to break emulation; the break occurs on the instruction during which the break 
is initiated (i.e., the last instruction that is executed before leaving emulation mode). 
Emulation cannot be resumed through this line. 


NOTE 


In order for the BRKEXT facility to function, a jumper wire must be in 
place on the 86 Controller board, connecting J2 (the ‘X’ cable terminal), pin 
40, to RP1 (a resistor pack), pin 5. New ICE-86A products are shipped with 
this wire already installed. The user may be required to have this wire 
attached on upgrades to previously existing ICE-86 emulators. Before 
attempting to use the BRKEXT facility, the operator should examine the 86 
Controller board to determine if this jumper wire is in place. | 


The (MATCHO or MATCH1)/ line can previde: a trigger sigwal whenever a Breaks 
point register condition is fulfilled. (See Chapter 6 for the setting of breakpoint 
registers.) The signal is active low and one clock cycle in duration. The user should © 
be aware that a pulse from the (MATCHO or MATCH1)/ line is not synonymous 
with a break in emulation; the ICE-86A emulator is capable of going out of emula- 
tion mode only when a breakpoint register condition 1S met and that register has 
ee enabled by either the GO or GR commands. ee | 7 
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NOTE 


When the system CLOCK is set to INTERNAL, the logic of the ICE-86A 
emulator causes the (MATCH0O or MATCH1)/ signal to be held high. In 
general, this means that when the emulator is not connected to user hard- 
ware, there is no external signal available to indicate when a breakpoint 
condition has been met. (See Chapter 6 for the CLOCK commands.) 


NOTE 


If the user connects an ICE-88A buffer box to an ICE-86A system, the 
following error will be generated: 


WARN C2:HARDWARE MISSING 


The ICE-86A system will not function in this configuration. 


Generalized Development Cycle with the 
ICE-86A Emulator 


Figure 1-3 diagrams a generalized product development cycle using the ICE-86A 
emulator as a design aid. The sequence of events in developing a new product using 
the Intellec system with the ICE-86A emulator is approximately as follows: 


Complete the specifications for the prototype hardware design, software control 
logic, and integrated system performance. 


Organize both the hardware and software designs into logical blocks that are 
readily understandable, have well-defined inputs and outputs, and are easy to 
test. Breaking down the design is an interactive process, but is extremely 
valuable in reducing the time required for prototyping, programming, testing, 
and modification. 

Program the software modules in PL/M-86 and/or in ASM-86 assembly 
language, naming and storing the programmed modules as files under ISIS-Ik. 
Compile or assemble the modules, linking and loading the combinations you are 
ready to test, creating an object-code (machine language) version. Desk-check 
each module as it is completed. 


As software modules are ready for testing, load them into the ICE emulator, 
Intellec system, or diskette and emulate them via the ICE processor, using the 
ICE-86A emulator in the ‘software’ mode. The ICE-86A system allows you to 
use ICE-supplied memory as part of the ‘prototype’ system. The advantages of 
this feature to software development include: 


1. You do not have to be concerned about overflowing your prototype system 
memory in the initial stages of software development. You have the 
freedom to test the program and compact it later without HANNE to make 
room for extra memory in your prototype. 


2. You may test your program in RAM memory, and make patches quickly 
and easily without having to erase and reprogram PROM memory. In later 


test phases, the ICE module can control program execution from PROM or 


ROM in your prototype. The ICE module can map RAM memory to ICE- 
supplied memory to replace prototype memory in set increments, to test out 
software changes before reprogramming. 


As software modules pass initial stages of check-out, they can be loaded in the 
2K of ICE-86A memory for emulation and testing in ‘real-time’. 


Hardware prototyping can begin with just a 8086 CPU socket. Through 
ICE-86A mapping capabilities, ICE-supplied equivalents can be substituted for 


_ missing prototype hardware. As each module of the user’s hardware becomes 
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Figure 1-3. Typical Development Cycle with the ICE™ Module 


available, it can be added to the prototype, replacing the ICE-supplied 
equivalent. In this way, modules of software and hardware can be system tested 
as they become available. 


e You can use memory in ICE-supplied system to check the interaction of 
prototype hardware and proven software. The ability to map memory is helpful 
in isolating system problems. You can exercise all prototype memory from a 
program residing initially in ICE-supplied memory, and reassign memory block- 
by-block to the user’s system as code is verified. Hardware failures can then be - 
isolated quickly, because interactions between prototype parts occur only at 
your command. You do not have to use the prototype to debug itself. 


e The debugging/testing process can proceed through each hardware and 
software module, using ICE-86A commands to control execution and check 
that each module gets data or control information from the correct locations, 
and places correct data or other signals in the proper cells or output locations 
for subsequent modules to use. 


e Eventually, you test all hardware and software together. The program can 
reside in RAM or PROM in your system, or in RAM in the Intellec system. All 
other hardware can be in the prototype. The ICE-86A emulator, connected to 
the system through the microprocessor socket, can emulate, test, and trace all 
the operations of the system. 


e After the prototype has been completely tested, the ICE-86A emulator can be 
used to verify the product in production test. The test procedures you developed 
for the final prototype testing can serve as the basis for production test routines, 
running the program from metal-masked ROM in the production system. 


A Generalized Emulation Session 


This section describes the main steps in an emulation session. You may not always 
perform all the procedures given here in every emulation session, but the main 
outline is the same in all sessions. The discussion emphasizes some of the features of 
the ICE-86A emulator that have not been presented earlier. For the details of the 
command language, see Chapters 4 through 8. 


1. Install the [CE-86A hardware in the Intellec eiascis (see Chapter 2). 


2. If you are using any prototype hardware, remove socket protector and attach 
the cable that connects the user hardware to the ICE-86A circuit boards to the 
prototype via the 40-pin socket. Otherwise leave socket protecio! attached to the 
cable. 
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3. Boot the system, and obtain the hyphen prompt from the ISIS-II system. Enter 


the ICE86 command, and obtain the asterisk prompt from the ICE-86A 
emulator. 


. From the software to be tested, determine how many memory addresses in the 


Intellec system are required to perform the current emulation. For example, if 
your program presently uses 3K of memory but your prototype has only 1K 
installed, you need to ‘‘borrow’’ 2K of memory from the ICE-86A emulator. 


ICE-86A system memory is available from three sources: 2K of ‘‘real-time’’ 
ICE memory, extended Intellec RAM memory, and diskette memory. This 
memory is available for user program mapping and is organized in blocks of 1K 
(1024) bytes of contiguous memory. 1024 such blocks are logically available; the 
amount that is physically available depends upon what you have installed in the 
Intellec. 


The ICE memory provides you with 2K of RAM memory that enables you to 
run object code at approximately real-time speed. 


Intellec memory is capable of providing 960 1K blocks of logical address space. 
The Intellec system software occupies the lowest 64K of Intellec RAM memory. 
Therefore, any Intellec memory available to the user programs must be mapped 
to addresses above 64K (extended Intellec memory). The amount of Intellec 
memory physically available is dependent upon the number of card slots 
available in the Intellec system and the memory physically installed. (Do not use 
016 memory boards). If diskette memory is used, the full range of 1024 blocks 
of logical memory is available to the user program up to the size of the diskette. 


Typically, your program occupies logical locations in low memory. If you 
intend to use Intellec memory for this emulation, you must map the memory 
space used by your program into extended Intellec memory. The ICE-86A 
emulator stores the mapping in its memory map, and refers each memory 
reference in your program to the proper physical location in Intellec memory. 
For example, suppose your code requires absolute addresses 0000H to OFFFH 
(the ‘‘H’’ means hexadecimal radix), or 4096 contiguous locations beginning at 
location 0, the lowest address in memory. To map these addresses into the 
beginning of extended Intellec memory, the mapping command would be: 


MAP INTELLEC = 64 LENGTH 62 


This command declares that 62K of RAM memory is physically available in 
extended Intellec memory starting at the lower boundary of extended memory. 


MAP 0 LENGTH 4 =INTELLEC 


This command maps the logical memory required by your program to address 
the address space in lower Intellec extended memory. 


. Load your program from diskette into the memory locations you have mapped, 


using the LOAD command. 


. The ICE-86A emulator has three modes of operation: interrogation, continuous 
emulation, and single-step emulation. The asterisk prompt signals that the 


ICE-86A emulator is in the interrogation mode, ready to accept any command. | 


. In the interrogation mode, prepare the system for emulation by defining 


symbols and setting emulation breakpoints and tracepoints. 


ICE-86A software provides keywords for all 8086 registers and flags. In addi- 
tion, you may use symbols to refer to memory locations and contents. The user 
symbol table is generated along with the object file during PL/M compilation or 
ASM assembly. This table can be loaded into Intellec memory when the user 
program is loaded. 


You are encouraged to add to this symbol table any additional symbolic values 


_ for memory addresses, constants, or variables that you may find useful during 


system debugging. Symbols may be substituted for numeric values in any of the 
ICE-86A commands. 
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Symbolic reference is a great advantage to the designer. You do not need to 
recall or look up the addresses of key locations in your program, as they change 
with each assembly; you can use meaningful symbols from your source program 


instead. This facility is especially valuable for high-level language debugging. 


~ You can completely debug a program written in PL/M by referencing symbols 


10. 
- with continuous emulation, you can command the ICE-86A emulator to execute 


11. 


12: 


13. 


defined in the source code. You do not need to become involved with the 
machine level code generated by the compiler. For example, the ICE-86A 


command: 


GO FROM .START TILL .RSLT WRITTEN 


begins real-time emulation of the program at the address referenced by the label 
START in the designer’s PL/M-86 program. The command also specifies that 
the program is to break emulation when the 8086 microprocessor writes to the 
memory location referenced by RSLT. You do not have to be concerned with 
the physical locations of START and RSLT. The ICE-86A software supplies 
them automatically from information stored in the symbol table. 


. Enter a GO command to begin real-time emulation. The ICE-86A sniulalor uses 


a pseudo-register called the GO-register to contain the halting conditions that 
you have specified, either in the GO command or previously. 


. When emulation halts, you display the trace data collected during that 


emulation. The ICE-86A emulator loads trace data into a trace buffer. Using 
ICE-86A commands, you can position the trace buffer pointer to the informa- 
tion that you desire to review, and display one, several, or all the entries in the 
buffer. You can set the display mode to one frame per line or one instruction per 
line of display. 


To control emulation more precisely and to abn more detailed trace data than 


single-step emulation. After each step emulated, you can display the current 
entry in the trace buffer and the current settings of the 8086 registers and pins. 


You can examine and change memory locations, 8086 registers and flags, and 


I/O ports, to provide you with valuable information on program operation. 
You may alter data or register values to observe their effect on the next emula- | 


tion, or you can patch in changes to your program code itself. You can display 
and change symbolic values 1 in the symbol table and breakpoint and tracepoint 
values. 


Alternate between interrogation and emulation until you have checked 
everything you want to check. 


At the end of the emulation session, you can save your debugged code on an 
ISIS-II diskette file, using the ICE-86A SAVE command. The operation can be 
specified to save program code, symbol tables, and Go PL/M programs) the 
source code line number table. 


You can start another session immediately, nesening all parameters to their 


initial values with a few simple commands, or you can exit to ISIS-II to ter- 


minate the session. 


This introduction is intended to show you some of the scope and power of the 
ICE-86A emulator in operation, and to suggest how this integrated software/ 


hardware design aid can fit into your development cycle. Chapter 2 contains installa- 


tion instructions. Chapter 3 contains a hands-on tutorial involving a sample pro- 


gram to be debugged. Chapter 4 describes the meta-notation used in this manual to 


specify command syntax and semantics. Chapter 5 presents a detailed description of 
expressions used in this manual. The remaining chapters present the details of the 


~command language in a format and sequence designed for reference. : 


ICE-86A 


CHAPTER 2 
ICE-86A" INSTALLATION 


PROCEDURES 


This chapter provides step-by-step instructions for installing ICE-86A hardware in 
an Intellec Microcomputer Development System. 


ICE-86A Components 


The following items are included in the ICE-86A package. 


e FM Controller board: A circuit board that plugs into the Intellec chassis. The 
FM Controller contains the 8080 ICE processor, 12K-byte firmware ROM, and 
3K-bytes of scratchpad RAM 


¢ 86 Controller board: A circuit board that plugs into the Intellec chassis. The 86 
Controller contains the 2K-bytes of ICE RAM, the 1K by 6-bit MAP memory, 
and $12 bytes of 2-Port memory. 


e  ICE-86A Trace board: A circuit board that plugs into the Intellec chassis. The 
ICE-86A Trace board contains RAM for trace data, tracepoints, and 
breakpoints. i 


e ICE-86A Buffer Box Assembly: A cable assembly that contains the ICE-86A 
Buffer Box Assembly. The Buffer Box contains two small circuit boards that 
contain the 8086 user processor and gating and control logic for communica- 
tions with the user system, MAP RAM, ICE RAM, 2-Port RAM, and Trace 
RAM. The cable assembly also contains the user cable that plugs into the 40-pin 
socket that normally houses the user’s 8086, the ‘‘X”’ cable that attaches to the 
86 Controller board, and the ‘‘Y’’ cable that attaches to the FM Controller 
board. 


e Intellec Model 800 Triple Auxiliary Connector and Intellec Series II Triple 
Auxiliary Connector: Each connector consists of a set of three parallel circuit 
board connectors that provide electrical interconnection between the FM 
Controller, ICE-86A Trace board and the 86 Controller when they are installed ~ 
in the Intellec chassis. 


e The ‘‘T’’ cable that connects the Trace board to the 86 Controller board. 


e Ground Cable: A cable that provides signal ground to the ICE-86A Buffer Box 
Assembly from the user system. 


e Software files on the ICE-86A diskette: 


e ICE86 e ICE86.OV7 e RBF89 e RBF89.0OV7 
e ICE86.0V0 ¢ ICE86.0V8 ¢ RBF89.0OV0 e RBF89.OV8 
e ICE86.0V1 e ICE&86.0V9 e RBF89.0V1 e RBF89.OVB 
e ICE86.0V2 ¢ ICE&86.0VA ¢ RBF89.0OV2 e RBF89.0VC 
e ICE86.0V3 e ICE86.OVE e RBF89.0V3 e RBF89.O0VD 
e ICE86.0V4 ¢ §8087.MAC | °e RBF89.0V4 e RBF89.OVE 
¢ ICE86.0V5 e 8087.HLP °¢ RBF89.OV5 

¢ ICE&86.0V6 e ERROR.MAC  ¢ RBF89.0V6 


These files provide the software to support design of systems using the 8086, the 
8087, and the 8089 chips. | 


Required and Optional Hardware 


The ICE-86A emulator requires one of the following hardware configurations: 
¢ — Intellec model 800 with: | 
CRT 
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Microcomputer Development System 2DS or DDS | 
64K of RAM 
3 adjacent card slots available on me motherboard 


Intellec model 888 with 64K of RAM and 3 adjacent card slots available on the 
motherboard. 


Intellec Series II, model 220, 225, or 230, or Intellec Series III model 286 with: 
3 adjacent card slots available in the expansion chassis and 64K of RAM 


| The following are optional enhancements to an ICE-86A system: 


Teletypewriter or line printer for hard-copy output 


One or more boards of Intellec expansion memory. If Intellec expansion 
memory is to be used for emulating 8086 program memory, additional card slots 
are needed for iSBC 032 or iSBC 064 memory boards. If Intellec expansion 
memory is used, it is recommended that all Intellec memory consist of iSBC 032 
and/or iSBC 064 memory boards. iSBC 016 memory boards decode only 16 bits 
of address. Therefore, if any iSBC 016 boards are present when expansion 
memory is being used, each 16K RAM board will be duplicated on each 64K 
page of addressable memory making these duplicated areas unusable for pro- 
gram storage. 


NOTE 


The Monitor in the Intellec model 800 and 888 occupies the upper 
2K of the first 64K of Intellec memory. This address space will be 
duplicated on each 64K page of Intellec expansion memory used 
and therefore unusable for user program storage. 


Hardware Installation Procedures 


Installation procedures are presented in the next two sections as follows: the pro- 
cedure for Intellec model 800 and 888; the procedure for Intellec Series I] model 220, 
225, 230, and the Intellec Series III model 286. 


Installation Procedures for Intellec Model 800 and 888 


WN — 


side of the Trace : board. ue 
. Install the FM Controller Bond next to the Trace board in the odd slot with the 


. Install the 86 Controll : 


~ Inspect the ICE-86A assemblies for damage. 

. Disconnect power cords from the Intellec chassis and the user system. 

. Remove the top cover from the Intellec chassis. 

. Ensure that shorting plug Pl on the FM Controller board connects Jumper posts 


E1-2, setting the ICE-86A device code to 0. Ensure that shorting plug P2 on the 
FM Controller board connects j umper posts E7-E8, selecting the Multibus inter- 
face -—10V power source as:the board’ s—S5V supply. 


. Insert the P2 edge connector of the ICE-86A Trace board into the middle slot of 


the Intellec model 800 Triple Auxiliary connector. 


. Install the Trace board (with Triple Auxiliary Connector she into an even 


numbered slot in the As cardgige so that there is an empty card slot on each 


number lower than the Trace board. For example, when the Trace board is in 
slot 10, the FM Controller board is placed in slot 9. | 

ard next to the Trace board in the slot with the 
ace board. Figure 2-1 shows the proper order of the 


number higher than the ’ T 
boards i in the cardcage. 
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NOTE 


The Triple Auxiliary Connector can be bolted to the motherboard 
if permanent installation of the ICE-86A Module is desired. The 
bottom cover of the Intellec chassis must be removed to gain access 
to the mounting holes (mounting hardware is supplied with the 
connector). 


. Attach the ‘T’ cable to the ‘T’ connectors on the Trace board and the FM 
Controller board, ensuring that the missing pin on the connectors mates prop- 
erly to the blocked hole in the cable receptacles. 


10. Attach the ribbon cable marked ‘X’ from the Buffer Box Assembly to the ‘X’ 
connector on the 86 Controller board, ensuring that the missing pin on the con- 
nector mates properly to the blocked hole in the cable receptacle. 


11. Attach the ribbon cable marked ‘Y’ from the Buffer Box Assembly to the ‘Y’ 
connector on the FM Controller board, ensuring that the missing pin on the 
connector mates properly to the blocked hole i in the cable receptacle. 

12. Install expansion RAM in the Intellec chassis as required for user software. 

13. If a user prototype is to be connected, remove the Socket Protector Assembly 
from the user end of the ICE-86A Buffer Box Assembly and insert the 40-pin 
cable terminal into the 8086 socket on the user system. The Socket Protector 
Assembly guards the terminal pins from damage and inadvertent grounding. 


Ensure that pin | of the terminal connector is aligned to pin 1 of the 
40-pin user system CPU socket. Damage to ICE oper may 
result when the connector Is mupropelly installed. 


\o 
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16. 


17. 


18. 


. Mount the male plug of the Ground Coaiectoe into the female receptacle of the 


Terminal Pin at the user end of the cable assembly. © 


. Mount the clip end of the Ground Connector to an appropriate point in the user 


system to provide signal ground. 


feauion} 


Failure to observe proper grounding techniques between the ter- 
minal connector ground lead and the user system may result in 
ICE-86A failures. 


Route the *X’ and ‘Y’ cables out the back of the chassis, over the top lip on the | 


rear panel. 


Replace the top cover on the Intellec chassis. The cover fits snugly over the two 
ICE cables at the back of the chassis. 


Connect the power cords to the Intellec chassis and the user system. 


Installation Procedures for Intellec Series Il Model 220, 225, 
and 230, and Intellec Series IIl Model 286 


1. 
Z: 


10. 


Inspect the I[CE-86A assemblies for damage. 


Disconnect power cords from the Intellec chassis, the expansion chassis, and the 
user system. 


. Remove the front panel from the expansion chassis. 
. Ensure that shorting plug P1 on the FM Controller board connects jumper posts 


E1-2, setting the ICE-86A device code to 0. Ensure that shorting plug P2 on the 
FM Controller board connects jumper posts E8-E9, selecting the Multibus inter- 
face —12V power source as the boards —5V supply. 


. Insert the P2 edge connector of the ICE-86A Trace board into the middle slot of 


the Intellec Series II Triple Auxiliary Connector. 


. Install the Trace board (with Triple Auxiliary Connector attached) into the 


expansion chassis so that there 1s an empty card slot on each side of the Trace 
board. 


. Install the FM Controller board in the expansion chassis slot immediately above 


the Trace board. 


. Install the 86 Controller board in the expansion chassis slot immediately below 


the Trace board. Figure 2-1 shows the proper order of the boards in the expan- 
sion chassis. 


NOTE 


The Triple Auxiliary Connector can be bolted to the expansion 

backplane if permanent installation of the ICE-86A Module is 

desired. The top cover of the expansion chassis must be removed to 

gain access to the mounting holes (mounting hardware is supplied 
- with the connector). 


. Attach the T cable to the Tp connectors on the Trace board and the FM 


Controller board, ensuring that the missing pin in the connectors mates Ore? 
to the blocked hole in the cable receptacles. - 


Attach the ribbon cable marked ‘X’ from the Buffer Box Assembly to the *X’ 
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connector on the 86 Controller board, ensuring that the missing pinonthecon- 


nector mates properly to the blocked hole in the cable receptacle. 
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11. Attach the ribbon cable marked ‘Y’ from the Buffer Box Assembly to the ‘Y’ 
Connector on the FM Controller board, ensuring that the missing pin on the 
connector mates properly to the blocked hole in the cable receptacle. 


12. Install expansion RAM in the Intellec mainframe or expansion chassis as 
required for user software. 


13. If a user prototype is to be connected, remove the Socket Protector Assembly 
from the user end of the ICE-86A Buffer Box Assembly and insert the 40-pin 
cable terminal into the 8086 socket on the user system. The Socket Protector 
Assembly guards the terminal pins from damage and inadvertent grounding. 


Ensure that pin | of the terminal connector is aligned to pin 1 of the 
40-pin user system CPU socket. Damage to ICE components may 
result when the connector is improperly installed. 


14. Mount the male plug of the Ground Connector into the female receptacle of the 
Terminal Pin at the user end of the cable assembly. 


15. Mount the clip end of the Ground Connector to an appropriate point in the user 
system to provide signal ground. 


Failure to observe proper grounding techniques between the ter- 
minal connector ground lead and the user system may result in 
ICE-86A failures. | 


16. Replace the front cover of the expansion chassis, routing the ribbon cable out 
the opening at the left side of the front panel. 


17. Connect the power cords to the Intellec mainframe and expansion chassis and 
user system. 


NOTE 


Keep the Socket Protector Assembly mounted on the end of the 
ICE Buffer Box Assembly terminal cable whenever the terminal is 
not attached to a user system to prevent pin damage. 


When removing the Socket Protector Assembly from the end of the 
ICE Buffer Box Assembly, use care to prevent pin damage. 


Accessing External Buffer Box Signals 
and Ground Pin 


As detailed in Chapter 1, the ICE-86A buffer box has four external signal lines— 
INITOUT/, (MATCHO OR MATCH1), EXTBRK, and EMUL—as well as a 
ground pin, to aid in coordinating user’s hardware with the ICE-86A emulator. One 
horizontal side of the buffer box has been left exposed to provide easy access to 
these signal lines and the ground pin; the user may make connections to external. 

_ hardware with any appropriate-sized electrical clips. For operator’s convenience, the 
lines and ground have been labeled | through 5 on the buffer box—1 for 
-INITOUT/, 2 for (MATCHO OR MATCH1)/, 3 for GND, 4 for EXTBRK, and 5 
for EMUL. | 


2-5 


ICE-86A Installation Procedures 


Confidence Testing 


The DIAG86 Confidence Test program verifies operation of the ICE-86A Module 
after installation or whenever problems with the ICE Module itself are suspected. 


The DIAG86 program resets and invokes the ICE-86A emiulator, executes a set of 


hardware confidence tests, and terminates by returning a ‘‘PASS”’ or ‘‘FAIL”’ 
display message. Execute the following sequence to run the confidence tests: 


Boot the system to run under ISIS-II and wait for the hyphen prompt (-) from 
the ISIS-II system. 


Enter the command CONF and wait for the asterisk prompt (*). 
Enter the command INIT DIAG86.CON and wait for the asterisk prompt (*). 


Enter the command TEST to cause DIAG86 to execute the confidence tests. 
Wait for the test message displays. DIAG86 will display a ‘‘PASS/FAIL”’ 


message for each diagnostic test contained in DIAGS86. If any displayed test 


message denotes a ‘‘FAIL’’, the installed hardware is not operating properly. 
Inspect the hardware for improper installation and rerun DIAGS86. If all the 
displayed test messages denote ‘‘PASS’’, the hardware has been installed cor- 
rectly and is operating properly. | 


Enter the command EXIT to return control to the ISIS-I] system. 
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This chapter introduces a few useful ICE-86A commands and provides hands-on 
experience with the ICE-86A emulator. To reduce the need for cross-reference, this 
chapter includes brief discussions of the commands used in the examples. The user 
program to be simulated is a simple traffic light controller. The user program logic is 
described before the hands-on session to help you understand what is going on. 


How To Use This Chapter 


To use this program as a hands-on tutorial, you must enter the source code for 
the two modules using the ISIS text editor on your system. Omit the line number 
and nesting information that is on the listing; these values are assigned by the 
compiler and assembler. 


Compile the CARS module with the PL/M-86 compiler program. Assuming 
that the source file is named ‘“‘CARS.SRC’’, the compile step could look like: 


—PLM86 :F1:CARS.SRC PRINT(:F1:CARS.PRT) DEBUG 


The object file created by PLM86 is named CARS.OBJ. (The DEBUG control 
generates the symbol table for use by ICE-86A.) 


Assemble the DELAY module with the ASM86 assembler. Assuming that the 
source file is named ‘‘DELAY.SRC’’, the assemble step could look like: 


—-ASM86 :F1:DELAY.SRC PRINT(:F1:DELAY.PRT) OBJECT(:F1:DELAY.OBJ) DEBUG 
As indicated, the object module is named DELAY.OBJ. 


Link and Locate CARS and DELAY using the iAPX-86 utilities LINK86 and 
LOC86. The command we used looks like: 


—LINK86 :F1:CARS.OBJ, :F1:DELAY.OBJ TO :F1:CARS.LNK 


The LINK86 command displays two warning messages when modules in 
DELAY.OBJ are combined. The output CARS.LNK must be located 
absolutely in memory using the LOC86 Command. 


—LOC86 :F1:CARS.LNK 


The file created by LOC86 is named CARS. This file will be the input used 
during the ICE86A session. 


For further information on the procedures for editing, compiling, assembling,. 
linking, and locating programs under iAP X-86, refer to the following manuals: 


Text Editor: ISTS-II System User’s Guide 
PL/M-86 Compiler: PL/M-86 User’s Guide 


ASM-86 Assembler 8086/8087/8088 Macro Assembly Language Reference 
Manual 
8086/8087/8088 Macro Assembler Operating 
Instructions 

LINK86 and LOC86 = 8086 Family Utilities User’s Guide 


Study the logic of CARS, the program to be emulated. The material includes 
text discussion and program listings. 


Install the ICE-86A hardware following the procedure given in Chapter 2. 
Leave the socket protector on to protect the pins at the end of the cable. 


Insert an ISIS-II system diskette in drive 0, boot ISIS. 


Copy CARS to the diskette containing the ICE-86A program. Insert this 
diskette in drive 1. 


CHAPTER 3 
SAMPLE ICE-86A™ SESSIONS 
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- Sample ICE-86A Sessions at the Terminal 


e Enter the command 
| “FA: ICE86 


to load the ICE software gad start it executing. The ICE- 86A emulator signals 
readiness to accept commands by displaying an asterisk prompt (*). 


e Enter the ICE-86A commands as shown, and obtain the results shown in the 
— jisting. 


Analysis of the Sample Program 


The application presented is a simple traffic light controller. Imagine an intersection 
of a main street and a side street. The desired operation is that the light should stay 
green on the main Street until a decision involving the number of cars waiting on the 
side street and the amount of time they have been waiting has been satisfied. We 
suppose that there is a sensor in the pavement on the side street that sends an inter- 
rupt to the computer when a car arrives. We do not include the control of a yellow 
light on either street. 


Refer to the following figures: 


Figure 3-1. CARS Module Listing 
| Figure 3-2. Delay Module Listing 


Associated with each street is a time called the cycle length. In the program, the 
variable named SIDE$CYCLE$LENGTH controls the fixed length of time the light 
is green on the side street when that cycle is called into action. Even though the light 
stays green on the main street until the decision rule is satisfied, we need a variable 
MAIN$CYCLE$LENGTH that is involved in the decision rule. 


The decision rule is as follows. The side street gets a green light if either of the 
following two conditions is satisfied. 


1. Two or more cars are waiting on the side street, and the main street has had 
the green light for a period of time greater than or equal to the variable 
MAIN$CYCLE$LENGTH. 


2. One car is waiting on the side street, and the main street has had the green 
light for a period of time equal to or greater than two times the variable 
MAIN$CYCLE$LENGTH. 


The system has one input and one output. The input is a signal that a car has arrived 
on the side street since the last time we sampled the input. The variable 
CARS$WAITING contains the number of cars waiting on the side street. The out- 
put goes to the traffic light controller. We assume that sending the controller a 1 
makes the light on the main street green and the light on the side street red; sending it 
a O makes the light on the main street red and the light on the side street green. The 
variable LIGHT$STATUS represents this output. 


The program is initialized with constants and variables set as follows. 


MAINS$SCYCLE$LENGTH = 8 seconds 

SIDE$CYCLE$LENGTH = 5 seconds 

MAINSTIME = 0 (Time since last change to MAIN GREEN, SIDE RED) 
SIDE$TIME = not set yet. (Time since last change to SIDE ee 
LIGHT$STATUS = 1 {MAIN| GREEN, SIDE Serta 

CARSSWAITING = -0 


The CARS program contains a procedure CYCLE to change the lights back and 
forth. CYCLE holds the side street light green (main red) until its counter, 


~ SIDETIME, exceeds the SIDECYCLELENGTH (nominally 5 seconds). 
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Sample ICE-86A Sessions at the Terminal 


TRAFFIC LIGHT CONTROLLER PROGRAM */ 


CARS: 


DECLARE (MAINSTIME, SIDE$TIME) BYTE; 

DECLARE MAINS$CYCLE$LENGTH BYTE DATA(8), SIDESCYCLESLENGTH BYTE DATA(5); 
DECLARE CARSSWAITING BYTE; 

DECLARE LIGHT$STATUS BYTE; 

DECLARE FOREVER LITERALLY ‘WHILE 1’; 


SIDESSTREETSCAR: 
PROCEDURE; 

CARSSWAITING = CARSSWAITING + 1; 
END SIDESSTREETSCAR; 


/* FOLLOWING PROCEDURE CODED IN ASSEMBLY LANGUAGE AND LINKEDIN */ 
DELAY: 
PROCEDURE(TIMESHUNDREDTHS) EXTERNAL; 
DECLARE TIMESHUNDREDTHS BYTE; 
END DELAY; 


DISPLAY: 
PROCEDURE (CYCLESTIME); 
DECLARE CYCLESTIME BYTE; 
LIGHTS$STATUS = LIGHT$STATUS; 
END DISPLAY; 


CYCLE: 
PROCEDURE; 
LIGHT$STATUS =0; /* MAIN RED, SIDE GREEN */ 
SIDESTIME = 0; 
DO WHILE SIDE$TIME <= SIDES$CYCLE$LENGTH; 
CALL DISPLAY(SIDES$TIME); 
CALL DELAY(100); 
SIDE$TIME = SIDESTIME + 1; 
END: . 
LIGHT$STATUS =1; /* MAIN GREEN, SIDE RED */ 
END CYCLE; 


/* MAIN PROGRAM — EXECUTION BEGINS HERE */ 
LIGHT$STATUS=1; /* START WITH MAIN GREEN */ 


CARSSWAITING = 0; 
MAINSTIME =0; 
DO FOREVER; 

CALL DISPLAY(MAINS$TIME); 

CALL DELAY(100); 

MAINS$TIME = MAINSTIME +1; 

IF (CARS$WAITING >= 2) AND (MAINSTIME >= MAINSCYCLE$LENGTH) 


DO; 
CALL CYCLE; 
CARSS$WAITING = 0; 
MAINSTIME = 0; 

END; 

END; 


END CARS; 


OR (CARSS$WAITING = 1) AND (MAINS$TIME >= 2 * MAINSCYCLESLENGTH) THEN 


Figure 3-1. CARS Module Listing 
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LOC 


0000 
0000 


0000 


come 


0000 
0000 


0002 


0003 
0005 
0007 
0009 
000B 
000F 
0013 
0017 
001B 
001C 
001E 
0020 
0022 


0023 
0023 


OBJ 


5B 

59 

53 

8AC1 
BSFF 
8ACD 
FEC9 
891E2300 
891E2300 
891E2300 
891E2300 
90 

75EB 
FEC8 
75E5 

C3 


02 


DVUDD 


LINE SOURCE 
1. CGROUP GROUP 
2 DGROUP GROUP 
3 ASSUME 
4 CONST SEGMENT 
5 CONST ENDS 
6 DATA SEGMENT 
7 DATA ENDS 
8 STACK SEGMENT 
9 STACK__BASE 


10 STACK ENDS 

11 MEMORY SEGMENT 
12 MEMORY_LABEL 

13. MEMORY ENDS 


14 ABS_0 SEGMENT 
15 M ~ LABEL 

16 

17 


18 ABS_0 ENDS 


ABS__0,CODE,CONST,DATA,STACK, MEMORY 
ABS__0,CODE,CONST,DATA,STACK,MEMORY 
DS:DGROUP,CS:CGROUP,SS:DGROUP 

WORD PUBLIC ‘CONST’ 


WORD PUBLIC ‘DATA’ 


WORD STACK ‘STACK’ 
LABEL BYTE 


WORD MEMORY ‘MEMORY’ 
LABEL BYTE 


BYTE AT0 
BYTE 
; TIME DELAY SUBROUTINE 


WORD PUBLIC ‘CODE’ 


19 CODE SEGMENT 
20 PUBLIC DELAY 
21 DELAY: POP BX ;POP RETURN ADDR. OFF.STACK 
22 POPCX ;POP ARGUMENT OFF STACK INTO CX REG. 
23 PUSH BX ;REPLACE RETURN ADDR. ON STACK 
24 MOV AL,CL -PL/M LINKAGE CONVENTION 
29 MOV CH,255 
26 LAB1: MOV CL,CH 
2/7 LAB2: DEC CL 
28 MOV TEMP,BX > WASTE 
29 MOV TEMP,BX ‘DITTO 
30 MOV TEMP,BX ae 
31 MOV TEMP,BX : 
32 NOP : 
33 JNZ LAB2 
34 DEC AL 
35 JNZ LAB1 
36 RET 
37 ; 
38 TEMP LABEL WORD 
39 DB 2 
40 CODE ENDS 
| A END 


Figure 3-2. DELAY Module Listing _ 
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The ICE-86A test suite includes commands that simulate the arrival of cars on the 
side street, and that display the values of the program variables involved in the light 
change logic. The procedure SIDESTREETCAR represents the nucleus of the inter- 
rupt routine that would handle the sensor interrupts in a real traffic light controller 
program. The interrupt-enabling logic is omitted for simplicity. Procedure 
DISPLAY is a ‘vestige’ of a previous version of CARS. CARS also calls DELAY 
when a ‘one-second’ timer is required. 


ICE-86A Emulator Hands-On Demonstration 


This demonstration involves the one program CARS. The version we ran did not 
have any serious kogic errors, so that the effects of the ICE-86A commands could be 
clearly seen. The length of the delay produced by the DELAY routine is longer than 
desired; you may adjust the calling parameter if you desire a ‘“‘true’’ one-second 
delay. 


The material represents two separate sessions at the terminal. The beginning and end 
of each session is clearly indicated. By using two sessions we can demonstrate the use 
of the PUT and INCLUDE commands. 


The pair of sessions is organized as follows—session 1 shows how to define and save 
macros on file; the macros defined in this session are of two kinds: general purpose 
MCS-86 utilities (PUSH86, POP86, SETIP) and macros that are particular to 
CARS, the demonstration program. 


The demonstration emphasizes the ICE-86A macro facility, showing how four basic 
ICE operations (initialize, emulate, display, change) can be organized into named 
blocks—the building blocks of test sequences. 
The define macro command has the syntax: 

DEFINE MACRO macro-name cr 

[Command cr}... 

EM 
The commands inside a macro definition (including calls to other macros) are 
not examined or executed by the ICE-86A emulator until the macro is invoked. A 


macro call has the format: :macro-name. More details on commands are given in the 
following discussion. 


3-5 


Sample ICE-86A Sessions at the Terminal 


oe 


Session 1 


0 We begin the session by eaten ‘FL: ICE86 to ISIS-II (hyphen ory fad | 
receive the ICE-86A sign-on message and asterisk prompt. To record the 


ICE- 86A session on diskette file, we enter a LIST command with the drive and 
filename that is to contain the output of the ICE-86A operations (including 
error messages if any). 


Many of the commands include comments. A comment is preceded by a 
semicolon (;) to separate it from the command. 


The discussion is keyed to the listing by margin numbers. 


Macro PUSH86 simulates the iAPX-86 PUSH instruction. SP is the stack 
pointer; SS is the base address of the stack segment. 


POP86 is the reverse procedure, simulating the iAPX-86 POP instruction. 


The parameter %0 in both PUSH86 and POP86 lets us ‘“‘push’’ or “‘pop”’ any 
register (or expression, etc.) as long as it can be expressed as a WORD-type 
quantity. : 


Macro SETIP resets the instruction pointer CS:IP to the address (symbol, 
expression, etc.) passed as a parameter when the macro is invoked. CS is the 
base of the code segment and IP is the instruction pointer relative to CS. Like 
PUSH86 and POP86, SETIP is a useful macro for restarting emulation at a 
desired point (without ‘softwiring’ start addresses into your emulation macros). 


Macro TYPES demonstrates how to set up to use typed memory references. A 
symbol that stands for the address of a variable (not a procedure name) can be 
defined or assigned a memory-type. Examples of memory-types are BYTE, 
WORD, and POINTER. In our CARS program, all the key variables are of 


type BYTE. Since the symbols are loaded with the program rather than being © 


DEFINED, we assign types to the variable with the commands of the form: 
TYPE .symbol-name = memory-type 


Then, as shown later on (e.g., in macro VARIABLES, step 6 of session 1) we 
can refer to the contents of any typed variable with a typed memory reference of 


- the form 


isymbol-name 


The contents produced by a typed memory reference are automatically of the 


_ type assigned or declared. 


See Chapter 7 for more details on memory types. 
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—:F1:ICE86 
ISIS-Il ICE-86/86A, V2.0 


*LIST :F1:DEC10.LOG SSESSION ONE 
*DEFINE MACRO PUSH86 


e*SP = SP — 2T ;MOVE POINTER TO NEW TOP OF STACK 
e*WORDSS:SP=%0. ;PUSH PARAMETER ON STACK 
°*EM ;END OF MACRO PUSH86 


*DEFINE MACRO POP86 

e*%0 = WORD SS:SP ;POP PARAMETER OFF STACK 
e*SP=SP + 2T ;MOVE POINTER TO NEW TOP OF STACK 
°*EM ;END OF MACRO POP86 


‘DEFINE MACRO SETIP 
°*CS = SEG (%0) 

°*IP = OFF (%0) 

°*EM —_;END OF MACRO SETIP 


*DEFINE MACRO TYPES 

e*TYPE .MAINTIME = BYTE ;FROM PLM LISTING 

e*TYPE SIDETIME =BYTE ;FROM PLM LISTING 

e*TYPE .MAINCYCLELENGTH = BYTE ;FROM PLM LISTING 
e*TYPE .SIDECYCLELENGTH = BYTE ;FROM PLM LISTING 
e*TYPE .CARSWAITING = BYTE ;FROM PLM LISTING 
e*TYPE .LIGHTSTATUS = BYTE ;FROM PLM LISTING 

°*EM , ;END OF MACRO TYPES 
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4 We define a macro INIT to handle the map and load steps for our program, 


CARS. 


In the macro INIT, the command MAP 0 LENGTH 2 = ICE 0 assigns two 
memory blocks (1K segments) to ICE memory. The CARS program was 
LOCATed at ORIGIN 0 (LOC86 step discussed above) to facilitate mapping to 
ICE memory. 


INIT defines a useful symbol, .START = CS:IP. After LOAD, CS:IP points to 
the first executable instruction in the user program. CS is the base of the code 
segment and IP is the instruction pointer (relative to CS). 


Then, INIT calls the TYPES macro defined in step 3. This macro will become 


part of INIT whenever INIT is called. Until INIT is called, however, the call to . 


TYPES is not executed. 


Finally, INIT displays the symbol and statement number tables, to verify that 
the LOAD step has been completed, and that the TYPES macro has executed. 


Macro EXAM is designed to test the logic that controls the light change. 
Basically, the macro block is an indefinite REPEAT loop (the block beginning 
with REPEAT and ending with ENDREPEAT). On each iteration a single step 
is emulated (one instruction). Following that, we use an IF command to look for 
certain addresses and take appropriate actions. The action taken in all cases is to 
display the PL/M statement or an equivalent message using the WRITE com- 
mand (see step 6 for more on the WRITE command). In addition, we skip both 
DELAY and DISPLAY by popping the return address and call parameter off 
the stack. 
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*DEFINE MACRO INIT 
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e*MAP 0 LENGTH 2=ICE0 ; MEMORY SPACE FOR CARS PROGRAM 


e*MAP 0 LENGTH 2 ;DISPLAY WHAT WE MAPPED 
e*LOAD :F1:CARS 


e*DEFINE .START = CS:IP ;HANDY SYMBOL FOR RESTARTING 
e*: TYPES ;MACRO FOR TYPE DEFINITIONS 


e*SYMBOLS 


e*LINES ;DISPLAY SYMBOL AND LINE NUMBER TABLES 


e*EM ;END OF MACRO INIT 


“DEFINE MACRO EXAM 

e*REPEAT 

e*STEP 

e*IF CS = SEG(.DISPLAY) AND IP = OFF(.DISPLAY) THEN 
e*WRITE ‘CALL DISPLAY’ 3 

e*:POP86 IP 7 ;RESTORE RETURN ADDRESS 
e*SP=SP + 2T ;DISCARD PARAMETER 

e*ORIF CS = SEG(.DELAY) AND IP = OFF(.DELAY) THEN 
e*WRITE ‘CALL DELAY’ 

e*:POP86 IP 

e*SP=SP + 2T | 

e*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
e*WRITE ‘STARTING MAIN LOOP’ 

e*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 
e*WRITE ‘START OF IF TEST’ 

e*:VARIABLES 

e*ORIF CS = SEG(.CYCLE) AND IP = OFF(.CYCLE) THEN 
e*WRITE ‘CALL CYCLE’ 


e* ENDIF 
e*ENDREPEAT 
°*EM ;END OF MACRO EXAM 
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Macro VARIABLES employs the WRITE command to display the key program 
variables with identifiers. The general syntax of WRITE i is: 


WRITE e/ement [, siemens 


~The elements to be “written” (displayed at the console) can be strings (e.g., 


‘SIDETIME’) enclosed in single quotes, expressions, or constants of the form 
BOOL expression. Two or more elements can be combined by listing them in 
the order you desire, separated by commas. The strings in our commands serve 


to label the displays. 


VARIABLES also uses typed memory references; they have the format: 
!isymbol-name 


Note that each of the symbol names in VARIABLES must be assigned a type 


(by macro TYPES) before LOOK can be called. Then, the typed reference pro- © 


duces the contents of the given address. For example, if symbol .A is the address 
of a variable of type BYTE, !A means the same thing as BYTE.A; if .A is a 
WORD-type variable, however, !A means WORD.A. 

The display produced by VARIABLES is shown in session 2 below. 

Macro TEST combines several macros and simple commands in a test suite. 
First we initialize the system by executing GO FROM START TILL ..CARS#30 
EXECUTED. Statement #30 in the beginning of the main loop. 


Next, TEST uses a parameter to assign a value to CARSWAITING. When we 
call TEST, we supply any value we wish as a parameter. 


Last, TEST calls EXAM to single step through the program SIDI ayINE any calls 
that occur. 


The DIR MAC command produces a display of the titles of all the macros we 
defined, in the order they were defined. 


To display the definition of any macro, use a command with the form: 
MACRO macro-name 


Using this command, we display the definition of macro SETIP. 


We save our macro definition on a permanent file for use in later sessions. 


The EXIT command closes all files and returns us to ISIS-II (hyphen prompt). 
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*DEFINE MACRO VARIABLES 


e*WRITE ‘LIGHTSTATUS =’, !LIGHTSTATUS,‘, CARSWAITING = ’, !CARSWAITING 
°e*WRITE ‘MAINCYCLELENGTH =’, !MAINCYCLELENGTH,‘, MAINTIME =’,!MAINTIME 
e*WRITE ‘SIDECYCLELENGTH =’, !SIDECYCLELENGTH,‘, SIDETIME =’,!SIDETIME 
°e*EM ;END OF MACRO VARIABLES 


*DEFINE MACRO TEST 


¢*GO FROM .START TILL ..CARS#30 EXECUTED 


e*(ICARSWAITING = %0 

e* ‘VARIABLES 

e* EXAM 

e*EM ‘END OF MACRO TEST 


*DIR MAC 
PUSH86 
POP86 
SETIP 
TYPES 

INIT 

EXAM 
VARIABLES 
TEST 


*MACRO SETIP 

DEFINE MACRO SETIP 

CS = SEG (%0) 

IP = OFF (%0) 

EM ;END OF MACRO SETIP 


*PUT :F1:TEST.INC MACRO 
“EXIT 
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Session 2 
0 Wecall up the ICE-86A program and specify a LIST file as before. 
1 The ENA EXP command enables the display of the macros so we can see the 
-block of commands making up each macro. The expansion is disabled when the 


ICE-86A emulator is first invoked. 


The INCLUDE command causes the ICE-86A emulator to read commands 
from a file rather than from the console. The form of this command is just: 


INCLUDE :drive: filename 


In our case, the file :FI1:TEST.INC contains the macro definitions from 
session 1. Thus, when we enter the command: 


INCLUDE :F1:TEST.INC 


The ICE-86A emulator reads in all the macro definitions from PUSH86 through 
TEST, then returns control to the console. 
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—:F1:ICE86 
ISIS-II ICE-86/86A, V2.0 


*LIST :F1:DEC11.LOG SSESSION TWO 
“ENA EXP 

*INCLUDE :F1:TEST.INC 

*DEFINE MACRO PUSH86 


e*SP =SP — 2T ;MOVE POINTER TO NEW TOP OF STACK 
e*WORD SS:SP = %0 ;PUSH PARAMETER ON STACK 
°*EM ;END OF MACRO PUSH86 


*DEFINE MACRO POP86 

«*%0 = WORD SS:SP ;POP PARAMETER OFF STACK 
e*SP=SP + 2T ;MOVE POINTER TO NEW TOP OF STACK 
°e*EM ;END OF MACRO POP86 

*DEFINE MACRO SETIP 

°*CS = SEG (%0) 

e*|P = OFF (%0) 

°*EM ‘END OF MACRO SETIP 

*DEFINE MACRO TYPES 

e* TYPE .MAINTIME=BYTE ;FROMPLM LISTING 

e*TYPE .SIDETIME BYTE ;FROMPLMLISTING 

e*TYPE .MAINCYCLELENGTH = BYTE ;FROM PLM LISTING 
e* TYPE .SIDECYCLELENGTH =BYTE ;FROM PLM LISTING 
e* TYPE .CARSWAITING = BYTE ;FROM PLM LISTING 
e*TYPE .LIGHTSTATUS = BYTE ;FROM PLM LISTING 


e*EM “END OF MACRO TYPES 

*DEFINE MACRO INIT 

e*MAP 0 LENGTH 2=ICE0 “MEMORY SPACE FOR CARS PROGRAM 
e*MAP 0 LENGTH 2 ‘DISPLAY WHAT WE MAPPED 

e*LOAD :F1:CARS 

e*DEFINE .START =CS:IP “HANDY SYMBOL FOR RESTARTING 

e*: TYPES “MACRO FOR TYPE DEFINITIONS 
e*SYMBOLS 

e*LINES SDISPLAY SYMBOL AND LINE NUMBER TABLES 
e*EM “END OF MACRO INIT 

*DEFINE MACRO EXAM 

e*REPEAT 

e*STEP 


**IF CS = SEG(.DISPLAY) AND IP = OFF(.DISPLAY) THEN 
e*WRITE ‘CALL DISPLAY’ 

e*:POP86 IP ;RESTORE RETURN ADDRESS 
e*SP=SP + 2T ;DISCARD PARAMETER 
e*ORIF CS = SEG(.DELAY) AND IP = OFF(.DELAY) THEN 
e*WRITE ‘CALL DELAY’ 

e*:POP86 IP 

e*SP=SP + 2T 

e*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
e*WRITE ‘STARTING MAIN LOOP’ 

e*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 
e*WRITE ‘START OF IF TEST’ 

e*: VARIABLES 

e*ORIF CS = SEG(.CYCLE) AND IP = OFF(. OTCEE) THEN 
e*WRITE ‘CALL CYCLE’ 


e* ENDIF 
e*ENDREPEAT 
e*EM ;END OF MACRO EXAM 


*DEFINE MACRO VARIABLES 
e*WRITE ‘LIGHTSTATUS = ’. ILIGHTSTATUS, ‘, CARSWAITING = ’,!CARSWAITING 
e* WRITE ‘MAINCYCLELENGTH = ’,!MAINCYCLELENGTH, ‘, MAINTIME = ’,!MAINTIME 
e* WRITE ‘SIDECYCLELENGTH = ’,!SIDECYCLELENGTH, ‘, SIDETIME =’, !SIDETIME 
°*EM -END OF MACRO VARIABLES 

*DEFINE MACRO TEST 

**GO FROM START TILL ..CARS#30 EXECUTED 

e* ICARSWAITING = %0 

e*:VARIABLES 

°*:EXAM | 

°*EM END OF MACRO TEST 
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2 We invoke macro INIT with a macro call of the form: 


:macro-name 
In our example, the call is: 
INIT 


First, the macro Is ‘‘expanded’’ to form a block of executable commands. The 
expansion is displayed since we previously enabled the display. The expansion 
of INIT involves expanding the macro TYPES at the point that TYPES is called 
within INIT (see the definition of INIT on the previous page). As INIT is 
expanded, each command is checked for syntax; any error here would abort the 
macro call. However, no errors occur and we reach the EM token marking the 
end of the macro expansion. 


The commands in INIT now execute. The MAP commands allocate space in 
ICE memory for our code and display the resulting map (T indicates decimal 
radix): | 


QOOOT=ICE 0000T 0001T=ICE 0001T 


The SYMBOLS command displays the symbol table; the listing shows the sym- 
bol names and corresponding addresses. We see that .START is present in an 
unnamed module at the head of the table, and other symbols are listed in the 
order they appear within the two program modules, ..CARS and ..DELAY. 
Note the type specifications on the program variables named in the macro 
TYPES. : 


The LINES command displays the statement numbers and corresponding 
addresses from CARS. DELAY has no line numbers because the assembler does 
not produce a line number table. | 
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“INIT 

e*MAP 0 LENGTH 2= ICE 0 “MEMORY SPACE FOR CARS PROGRAM 
e*MAP 0 LENGTH 2 ‘DISPLAY WHAT WE MAPPED 

e*LOAD :F1:CARS 

e*DEFINE .START = CS:IP “HANDY SYMBOL FOR RESTARTING 

e* TYPES ‘MACRO FOR TYPE DEFINITIONS 


ee* TYPE .MAINTIME = BYTE ;FROM PLM LISTING 

ee* TYPE .SIDETIME =BYTE ;FROMPLMLISTING 

ee* TYPE .MAINCYCLELENGTH = BYTE ;FROM PLM LISTING 
ee* TYPE SIDECYCLELENGTH BYTE ;FROM PLM LISTING 
ee* TYPE .CARSWAITING = BYTE ;FROM PLM LISTING 

ee* TYPE LIGHTSTATUS = BYTE ;FROM PLM LISTING 


ee*EM ;END OF MACRO TYPES 

e*SYMBOLS 

e*LINES ;DISPLAY SYMBOL AND LINE NUMBER TABLES 
e*EM ;END OF MACRO INIT 


OOOOT=ICE 0000T 0001T=ICE 0001T 
«CODE=0020:0000H 
eCONST=002F:000CH 
*DATA=002F :000EH 
*STACK=0030:0002H 

e MEMORY =0031:0000H 
©?2?SEG=0031:0000H 
*ABS__0=0000H 
*CGROUP=0000H 
¢DGROUP=0000H 
*START=0202H 

MODULE ..CARS 
*MEMORY=0310H 
eMAINTIME=02FEH OF BYT 
eSIDETIME=02FFH OF BYT 
eMAINCYCLELENGTH=02FCH OF BYT 
eSIDECYCLELENGTH=02FDH OF BYT 
eCARSWAITING=0300H OF BYT 
eLIGHTSTATUS=0301H OF BYT 
eSIDESTREETCAR=028DH 
eDISPLAY=0296H 
eCYCLE=02A5H 

MODULE ..DELAY 
*DELAY=02D8H 

eLAB1=02DFH 

eLAB2=02E1H 

eM=0000H 
eMEMORY__LABEL=0031:0000H 
*STACK__BASE=0030:000CH 
eTEMP=0020:00FBH 

MODULE ..CARS 

#1=028DH 

#2=028DH 

#3=028DH 

#4=028DH 

#5=028DH 

#6=028DH 

#7=028DH 

#8=0290H 

#9=0294H 

#10=0296H . 
#11=0296H 

#12=0296H 

#13=0296H 

#14=0299H 

#15=0299H 

#16=02A1H 

#17=02A5H 

#18=02A8H 

#19=02ADH 

#20=02B2H 

#21=02BFH 

#22=02C3H 

#23=02C9H 

#24=02CDH 

#29=02D0H 
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4 We now invoke macro TEST to exercise the ‘program logic. We wish to 
demonstrate that the code will branch to CYCLE when either of the following 
two conditions is true: 

1) CARSWAITING =1 AND MAINTIME >= 16 seconds 
2) CARSWAITING >= 2 AND MAINTIME >= 8 seconds 
In the definition of TEST (look back at step 1) the second command is: * 


ICARSWAITING = %0 


The parameter %0 lets us set the contents of CARSWAITING to any BYTE 
quantity we require. Thus we test condition 1 by our command: 


TEST 1 
This results in the expansion: 
ICARSWAITING = 1 


The expansion of TEST involves the expansion of the macros VARIABLES and 
EXAM at the point each is called in the body of TEST. 


Macro TEST now begins to execute. To help us follow the displays, we can iden- 
tify some key addresses in the portions of code we are CHECKING, as shown in 
table 3-1. : 

Table 3-1. Key Addresses in CARS Logic 


PLACE IN 
CARS CODE 


LINE # 
NUMBER 


ADDRESS (IP) | 


#27 
#30, 31 
#34 
#35, 36 
#37 
#39, 40 
#13 
#17 
#26 
(#17) 
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START OF MAIN PROGRAM (.START) 
START OF MAIN ‘DO’ BLOCK 

START OF IF TEST 

START OF CONDITIONAL ‘DO’ BLOCK 
POINT OF RETURN FROM ‘CALL CYCLE’ 


END OF BOTH CONDITIONAL AND MAIN ‘DO’ BLOCKS 


BEGINNING OF DISPLAY (SKIPPED) 
BEGINNING OF CYCLE 

END OF CYCLE . 

BEGINNING OF DELAY (SKIPPED) 
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#26=02D5H 
#27=0202H 
#28=0215H 
#29=021AH 
#30=021FH 
#31=021FH 
#32=0226H 
#33=022CH 
#34=0236H 
#35=027BH 
#36=027BH 
#37=027EH 
#38=0283H 
#39=0288H 
#40=0288H 
#41=028BH 
MODULE ..DELAY 


* 


*:-TEST 1 

e*GO FROM .START TILL ..CARS#30 EXECUTED 

e*!ICARSWAITING = 1 

e*:- VARIABLES 

ee* WRITE ‘LIGHTSTATUS =’, !LIGHTSTATUS,‘, CARSWAITING =’ ,!CARSWAITING 
ee* WRITE ‘MAINCYCLELENGTH =’, !MAINCYCLELENGTH,‘, MAINTIME =’, !'MAINTIME 
ee* WRITE ‘SIDECYCLELENGTH =’,!SIDECYCLELENGTH,'‘, SIDETIME =’,!SIDETIME 
ee*EM -END OF MACRO VARIABLES 

e*-EXAM 

ee* REPEAT 

ece* STEP 

eee*|F CS = SEG(.DISPLAY) AND IF = OFF(.DISPLAY) THEN ° 

eooe* WRITE ‘CALL DISPLAY’ 


ecee*:POP8E IP ;RESTORE RETURN ADDRESS 


ececeee*|P = WORD SS:SP ;POP PARAMETER OFF STACK 
eeeee*SP=SP + 2T ;MOV POINTER TO NEW TOP OF STACK 
ecooe* EM ;END OF MACRO POP86 


eeoe*SP = SP + 2T ;DISCARD PARAMETER 
eeee*ORIF CS = SEG(.DELAY) AND IP = OFF(.DELAY) THEN 
eooe* WRITE ‘CALL DELAY’ 
ecee* -POP86 IP 

eceee*|P = WORD SS:SP 
ecooe*SP=SP + 27 

eccoe* FM 

ecoe*SP=SP + 27 
eceee*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 

eccoe* WRITE ‘STARTING MAIN LOOP’ 

eceee*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 

ecoe* WRITE ‘START OF IF TEST’ 

ecoe* VARIABLES : 

ecoee* WRITE ‘LIGHTSTATUS = ’, !ILIGHTSTATUS,‘, CARSWAITING = ’, !SCARSWAITING 
ecooe* WRITE ‘MAINCYCLELENGTH = ’,!MAINCYCLELENGTH,‘, MAINTIME =’, !MAINTIME 
ecooe* WRITE ‘SIDECYCLELENGTH = ’, |SIDECYCLELENGTH,‘, SIDETIME = ’, !SIDETIME 
eooee* EM ;END OF MACRO VARIABLES 

eceee*ORIF CS =(.CYCLE) AND IP = OFF(.CYCLE) THEN 

ecooe* WRITE ‘CALL CYCLE’ 

ecoee* ENDIF 

eoce* FNDREPEAT 

ee*EM ‘END OF MACRO EXAM 


;POP PARAMETER OFF STACK 
;MOVE POINTER TO NEW TOP OF STACK 
;END OF MACRO POP86 


— @*EM ;END OF MACRO TEST 
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The messages ‘EMULATION BEGUN’ and ‘EMULATION TERMINATED, 
CS:IP = 0000:0223’ are produced by the command ‘GO FROM .START TILL 
_CARS#30 EXECUTED.’ 


The next three display lines are produced by macro VARIABLES. We see that 


LIGHTSTATUS is 1 (main street green), and that CARSWAITING has 
been set to 1 by the command ‘!CARSWAITING = I in TEST. 
MAINCYCLELENGTH and SIDECYCLELENGTH are constants at 8 and 5, 
respectively. MAINTIME is zero. | 


This is the beginning of the REPEAT loop in macro EXAM. The first STEP 
ends with address 0296H in the instruction pointer; this is the beginning of 
DISPLAY and macro EXAM displays the ‘CALL DISPLAY’ message. 


When the beginning of DELAY appears in CS:IP, EXAM displays ‘CALL 
DELAY’. 


Address 0236H is the address of the first instruction generated by the IF 
statement on line #34 of CARS. EXAM displays the message ‘START OF IF 
TEST’, and also displays (via a call to macro VARIABLES) the values of the 
variables involved in the IF condition. The only change since the last such 
display is that MAINTIME has been incremented to 1. 


ICE-86A 


ICE-86A | 


EMULATION BEGUN 


‘EMULATION TERMINATED, CS:1P=0000:0223H 


LIGHTSTATUS = 0001H, CARSWAITING = 0001H 


MAINCYCLELENGTH = 0008H, MAINTIME = 0000H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 


EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 


MAINCYCLELENGTH = 0008H, MAINTIME = 0001H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 


EMULATION BEGUN 
EMULATION TERMINATED, CS:1P=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:023DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:023FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0240H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0244H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0245H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0249H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:024FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0251H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0252H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0257H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0259H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:025DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0261H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0263H 
EMULATION BEGUN | 

EMULATION TERMINATED, CS:IP=0000:0265H 
EMULATION BEGUN — | 

EMULATION TERMINATED, CS:1P=0000:0267H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0269H 
EMULATION BEGUN | 
EMULATION TERMINATED, GS:IP=0000:026BH 
EMULATION BEGUN = 
EMULATION TERMINATED, CS:IP=0000:026DH 


EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:026EH 
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10 The previous thirty STEPs comprise the IF-test. Address 0278H is the end of the | 
IF test, and 0288H is the end of the main loop. Since address 027BH did not 


appear, we know that the conditional loop did not execute. 

11 Here we are at the beginning of the main loop in CARS. 

12 This time through the IF test, MAINTIME is 2. We omit most of the STEPs 
through the test (address 023BH to 0278H) from the text; these are identical to 


the series shown at step 9. 


13. The start of the main loop again; still no light change. 
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11 


12 


13 


EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:026FH 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0271H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0272H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0274H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0288H 


EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000: 0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 


MAINCYCLELENGTH = 0008H, MAINTIME = 0002H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 


EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:023DH 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:023FH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:iP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021 FH 
STARTING MAIN LOOP 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:iP=0000:0296H 
CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
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14 MAINTIME equals 3; still a long way to go until MAINTIME equals 16. We 
now omit all steps from the text except the beginning and end of the IF test, SO _ 
that we can concentrate on the value of MAINTIME. 

i) MAINTIME equals 4. 


16 MAINTIME equals 5. 


322, 
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15 


16 


EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0003H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 


e 
° 

® 

EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0004H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:I1P=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST i 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0005H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 
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17 MAINTIME equals 6. 
18 MAINTIME equals 7. 


19 MAINTIME equals 8. 


ICE-86A 
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18 


19 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:021FH. 


STARTING MAIN LOOP 
EMULAITON BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0006H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0007H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:I1P=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0008H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 
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20 MAINTIME equals 9. 


21. MAINTIME equals 10 (OAH). 


ICE-86A 


20 


| 


3 


EMULATION TERMINATED, CS:1P=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0009H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN ° 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000AH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021 FH 
STARTING MAIN LOOP 

EMULATION BEGUN 
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22. MAINTIME equals 11 (OBH). 
23 MAINTIME equals 12 (OCH). 


24 MAINTIME equals 13 (ODH). 


ICE-86A 
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23 


24 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000BH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:iP=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:!IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:iP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000CH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000DH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN es 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!P=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARING MAIN LOOP 

EMULATION BEGUN 
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25 MAINTIME equals 14 (OEH). 

26 MAINTIME equals 15 (OFH). 2 

27 Finally, MAINTIME equals 16 or two times MAINCYCLELENGTH. This 
time the condition “CARSWAITING = 1 AND MAINTIME >= 2 * MAIN- 
CYCLELENGTH’ is TRUE and we should see a call to CYCLE at the end of 
the IF test. | 
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EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST —_ 

25 LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000EH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:1IP=0000:023BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:1P=0000:0278H 
EMULATION BEGUN | 
EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN , 
EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


e 
e 
e 


EMULATION TERMINATED, CS:!P=0000:0236H 
START OF IF TEST 

26 LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000FH 
SIDECYCLELENGTH = 0005H, 'SIDETIME = 0070H 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN | | 
EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN 


« 


EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST | 

27 LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0010H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:1P=0000:023BH 
EMULATION BEGUN eS 
EMULATION TERMINATED, CS:IP=0000:023DH 
EMULATION BEGUN it ee 
EMULATION TERMINATED, CS:IP=0000:023FH 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0240H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0244H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:1P=0000:0245H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0249H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:1P=0000:024BH 
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28 Address 027BH in the beginning of the conditional ‘DO’ loop. 


29 Here is the beginning of CYCLE (OA7H). CYCLE 1s a loop controlled by the 
statement ‘DO WHILE SIDETIME <= SIDECYCLELENGTH’; 
SIDECYCLELENGTH is 5, so the loop should exit when SIDETIME equals 6. 
We could have included ICE-86A commands in macro EXAM to examine 
CYCLE more closely (LIGHTSTATUS should be set to zero, and SIDETIME 
should increment on each iteration). In our example, however, we simply wait 
for CYCLE to return to the main program. The rest of the display on this page 
shows two iterations of CYCLE. We have omitted the printout of the remaining 
iterations. | 
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EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000: 0251H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0252H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0257H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0259H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025CH 
EMULATION BEGUN. 

EMULATION TERMINATED, CS:IP=0000:025DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0261H 
EMULATION BEGUN | 
EMULATION TERMINATED, CS:!P=0000:0263H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!IP=0000: 0265H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0267H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!1P=0000:0269H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:I1P=0000:0271H 
EMULATION BEGUN 7 
EMULATION TERMINATED, CS:IP=0000:0272H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0274H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP = 0000:027BH 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:02A5H 
CALL CYCLE 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02A6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02A8H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02ADH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BFH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP= 0000: 02C0H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 

CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
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30 Address 02DS5H is the end of CYCLE. Two steps later, O27EH is Re. return 
address from the call to cycle. 
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EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:02CDH 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:02BFH 


_ EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:02COH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:02C6H — 


EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02CDH 
EMULATION BEGUN 

EMULATION TERMINATED, CS: IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, Cs: IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BFH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C0H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 

CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:1P=0000:02C5H 


EMULATION TERMINATED, CS:IP=0000:0296H 

CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02CDH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BCH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D0H 


EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:02D5H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:!IP=0000:02D6H 
EMULATION BEGUN 


~ EMULATION TERMINATED, CS:IP=0000:027EH 


EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:0283H 
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32 


33 


34 


Here we are back at the start of the main loop. 


The display of variables shows LIGHTSTATUS at | and CARSWAITING at 
zero. SIDETIME is 6 as we expected. MAINTIME is 1 and will continue to 
increment as long as we allow the program to emulate. 


We sence: this test ‘successful’, and abort the emulation by pressing the ESC 
key. 


Now to test the second condition. The macro call ‘TEST 2’ produces an 
expansion of macro TEST; this time CARSWAITING is set to 2. Otherwise, the 
expansion produces an executable macro identical to “TEST 1’ shown in step 4. 
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EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 

EMULATION BEGUN | 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:!IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0000H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0001H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 
PROCESSING ABORTED 


*:TEST2 = 

e*GO FROM .START TILL ..CARS#30 EXECUTED 

e* ICARSWAITING = 2 

e*:- VARIABLES 

ee*WRITE ‘LIGHTSTATUS =’, ILIGHTSTATUS,‘, CARSWAITING =’, '|CARSWAITING 
ee* WRITE ‘MAINCYCLELENGTH =’ ,!MAINCYCLELENGTH,‘, MAINTIME =’,!MAINTIME 
ee*WRITE ‘SIDECYCLELENGTH =’, 'SIDECYCLELENGTH,‘, SIDETIME =’, ‘SIDETIME 
ee*EM “END OF MACRO VARIABLES . 

e*-EXAM 

ee*REPEAT 

ecee*STEP 

ecee*iF CS =SEG(.DISPLAY) AND IP = OFF(.DISPLAY) THEN 

ecee* WRITE ‘CALL DISPLAY’ 


eccoo*:-POPS8EIP - ~ sSRESTORE RETURN ADDRESS 
eceeee*|P = WORD SS:SP ;-POP PARAMETER OFF STACK 
ecoooe*SP=SP + 2T sMOVE POINTER TO NEW TOP OF STACK 
ecooe* FM “END OF MACRO POP86 
eceee*SP=SP + 2T _ ;DISCARD PARAMETER 


eeee*ORIF CS = SEG(.DELAY) AND IP = OFF DELAY) THEN 
eooe* WRITE ‘CALL DELAY’ 
eoee*:POP8E6 IP 
eeeee*IP =WORDSS:SP — ;POP PARAMETER OFF STACK 
eeeee*SP=SP + 2T -MOVE POINTER TO NEW TOP OF STACK 
eoeee*EM -END OF MACRO POP86 
eooe*SP =SP + 2T 
eeee*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
eooe* WRITE ‘STARTING MAIN LOOP’ 
eeee*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 
ecee*WRITE ‘START OF IF TEST’ - 
eeee*:- VARIABLES 
ecece* WRITE ‘LIGHTSTATUS = ’, ILIGHTSTATUS,‘, CARSWAITING = ’,!CARSWAITING 
eeeee* WRITE ‘MAINCYCLELENGTH = ’,!MAINCYCLELENGTH,', MAINTIME = ’,!MAINTIME 
eecee* WRITE ‘SIDECYCLELENGTH =’ !SIDECYCLELENGTH , SIDETIME = ’,!SIDETIME 
eoece*EM -END OF MACRO VARIABLES 
eeee* ORIF CS = SEG(.CYCLE) AND IP = OFF(.CYCLE) THEN 
eoee* WRITE ‘CALL CYCLE’ 
eoee* ENDIF 
eee* ENDREPEAT 
oo*EM -END OF MAGRO EXAM 
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35 We emulate to the start of the main loop, as before. This time CARSWAITING 
is 2, and we should CALL CYCLE as soon as MAINTIME equa 8. We omit 
the intermediate steps. | 


36 MAINTIME is 8, equal to MAINCYCLELENGTH. 
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EMULATION BEGUN | 
EMULATION TERMINATED, CS:IP=0000:0223H 
LIGHTSTATUS = 0001H, CARSWAITING = 0002H 


MAINCYCLELENGTH = 0008H, MAINTIME = 0000H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 


EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001H, CARSWAITING = 0002H 


MAINCYCLELENGTH = 0008H, MAINTIME = 0001H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 


EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 


START OF IF TEST 
LIGHTSTATUS = 0001H, CARSWAITING = 0002H 


MAINCYCLELENGTH = 0008H, MAINTIME = 0008H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 


EMULATION BEGUN 

EMULATION TERMINATED, CS:!IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0240H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0244H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0245H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0249H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0251H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0252H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0257H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0259H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025BH 
EMULATION BEGUN | 
EMULATION TERMINATED, CS:IP=0000:025CH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025DH 
EMULATION BEGUN | 
EMULATION TERMINATED, CS:IP=0000:0261H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0263H 
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37 And here’s the beginning of CYCLE. Once more we omit the steps in CYCLE 
from the text. | 


38 This is the end of CYCLE, and the return to the main program. 


39 Back to the start of the main loop. 
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EMULATION BEGUN 
EMULATION TERMINATED, CS:|IP= 0000: 0265H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:1P=0000:0267H 
EMULATION BEGUN 


~ EMULATION TERMINATED, CS:IP=0000:0269H 


EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:I1P=0000:0271H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0272H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0274H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:027BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02A5H 
CALL CYCLE 

EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BCH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D0H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000: 02D6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:027EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0283H 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 

STARTING MAIN LOOP 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0298H 

CALL DISPLAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 

EMULATION BEGUN — 

EMULATION TERMINATED, CS:IP=0000:0229H 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 

START OF IF TEST 
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oO Wes consider this test ‘successful’, abort emulation, and exit from the ICE-86A 
emulator back to ISIS-I] (hyphen prompt). __ . 
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40 LIGHTSTATUS = 0001H, CARSWAITING = 0000H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0001H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN | 
EMULATION TERMINATED, CS:IP=0000:023DH 
PROCESSING ABORTED 


*EXIT 
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Introduction 


The ICE-86A software provides you with an easy-to-use English language command 
set for controlling ICE-86A execution in a variety of functional modes. 


The ICE-86A commands enable you to: 


e Initialize the ICE-86A system, map your program to memory in your system, 
ICE-86A memory, disk memory, or in the Intellec Microcomputer Development 
System, and load your program from a diskette file. 


e 6 Specify starting and stopping conditions for emulation. 

e Execute real-time emulation of your software (and hardware). 

e Execute single-step emulation. 

e Specify conditions for trace data collection. 

e Collect and display trace data on conditions occurring during emulation. 
e Display and alter 8086 registers, memory locations, and I/O ports. 


e Copy the (modified) program from mapped memory to a diskette file, and exit 
the ICE-86A system. 


An example of one complete ICE-86A command, in this case one of the forms of the 
GO command, is shown in figure 4-1. This command causes emulation to start and 
specifies the conditions that will halt emulation. The command is made up of ten 
separate ‘‘words’’ (character strings that are referred to as tokens): GO, FROM, 
0123H, TILL, 1000H, TO, 1100H, READ, USING, and CS. Each of these tokens 
provides a particular element of information necessary to inform the ICE-86A 
emulator of the specific command functions (see table 4-1). The tokens also form 
the following command components: the FROM clause, match-range, match-status, 
segment-register-usage, match-condition, and TILL clause. This string of tokens 
requests the ICE-86A emulator to start emulation at location 0123H and to continue 
emulation until data is read from any memory location within the match-range (par- 
_ tition) of addresses 1000H through 1100H using the CS segment register in the effec- 
tive address calculation. Every ICE-86A command is composed of one or more such 
tokens. 


GO FROM 0123H TILL 1000H TO 1100H READ USING CS 


token1 token2 token3 token4 token5 token6 token7 token8 tokenS token10 
FROM-clause match-range match- segment- 
Status register- 
usage 


—~=-_ -k r—a—_es eee eee 


match-condition 


Sn 


TILL-clause 


Figure 4-1. Example of a GO Command  162554-5 
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Table 4-1. Definition of GO Command Functions 


Token 
Number 


~ 0123H 


FROM clause 


1100H 


match-range 


CS 


segment-register-usage 


5 thru 10 match-condition 


4 thru 10 TILL clause 


Note: The match-condition consists of the three sub-conditions: match-range (tokens 


Function 


GO command specifier; requests and 
initiates emulation. 


Indicates that the next token or 
expression is the starting address for 
emulation. : 


Starting address in hexadecimal 
radix. 


FROM 0123H causes the instruction 
pointer (IP) to be loaded with 0123H, 
the starting address for emulation. 
Also, the code segment register (CS) 
is loaded with 0. 


Indicates that the breakpoint (halting) 
parameters are to follow. 


Specifies the lowest address of a 
range of memory locations. This 
parameter is the lower bound of a 
memory partition. 


Indicates that the upper bound 
(address) of. the range (partition) of 
memory locations is to follow. 


Specifies the highest address of the 
range of memory locations. 


Emulation is to halt ifan access to any 
memory location whose address falls 
within the range of 1000H to 1100H. 


Emulation is to halt if any of the above 
memory locations are read. 


Indicates a segment register is to 
follow. 


The code segment register(CS) must 
be used in the effective address 
calculation in order to match. 


Emulation is to halt if the CS is used. 


Emulation is to halt if data is read 
from any memory location in the 
match-range. 


TILL 1000H TO 1100H READ USING CS 
specifies that the emulation is to halt 
whenever the match-condition is 
met. This clause is also called the 


‘GO-register’ in the ICE-86A 


language. 


9,6,7), match-status (token 8), and segment-register-usage (tokens 9,10). All 
three of these conditions must be matched for emulation to halt. 


As preiy indicated i in ane 4-1, the ICE- 86A. commands are ‘writer in ‘an ICE- 86A 
command language composed of a unique character set and vocabulary of tokens 
augmented by a particular set of syntactic rules. The tokens are constructed from the 
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character set and in turn are used to construct commands. The tokens consist of a set 
of predefined literals augmented by user-defined literals that provide symbolic 
references. Table 4-1 contains the definition of each token shown in figure 4-1. 


The purpose of this chapter is to present a detailed specification of the ICE-86A 
command language. The language consists of two parts, a vocabulary that is used to 
convey elements of information to the ICE-86A emulator and a ‘‘grammar’’ (syn- 
tactic rules) used to group command words into command constructs such as the 
FROM clause shown in figure 4-1. The remainder of this chapter is devoted to the 
presentation of the command language. The initial discussion deals with class-names 
and the notation used to describe the language and will include a listing of the syn- 
tactic rules that govern command construction. This will be followed by a presenta- 
tion of the command literals (keywords) and a discussion of symbolic references. 


Notation and Conventions Used in This Manual 


This manual employs a set of notational symbols and conventions to describe the 
structure of commands and other language constructs. The features of this notation 
are described in the following paragraphs. Table 4-2 contains the notational symbols 
used to define and describe the command structures. 


Table 4-2. Notational Symbols 


‘is defined as’’ 


Mutual exclusion 


May be repeated indefinitely 


At least one entry must be selected. If more than one entry is 
- selected, they may be selected in any order. 


One of the enclosed entries must be selected. 


Selection of the enclosed entries is optional. If more than one entry is 
selected, they may be selected in any order. 


Selection of the enclosed entries is optional but only one entry may 
be selected. If this symbol encloses only one entry, that entry is 
optional. 


In addition to the above notational symbols, a set of class-names are used to assist in 
the definition and description of entities in the ICE-86A command language. Each 
class-name is an identifier for a specific set of characters, mnemonics, or constructs 


and is always shown in lower-case italics. Any character string not in lower-case 


italics is a specific character, mnemonic or construct. For example, the class-name 
segment-register refers to the entire class of segment registers. The character string 
CS refers to the Code Segment Register, which is one of the four segment registers. 


As shown in figure 4-1, the smallest meaningful unit of information contained 
within a command is a mnemonic character string that is the equivalent of a word. 
Examples are: GO, 0123H, and FROM. These mnemonics are assigned the class- 
name: token. In addition to these basic elements, the tokens are combined 
into multi-token forms such as the FROM clause and match-condition shown in 
figure 4-1. | | 
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The ICE-86A vocabulary is made up of two classes of mnemonics: tokens and 
special-tokens: 


token = constant :: keyword :: symbol :: string :: operand 
special-token = operator :: pupeialenauark :: delimiter :: terminator 


The notational symbol (::) specifies mutual exclusion. That is, a token is a constant, 
or keyword or symbol! or string or operand. 


Each of the above classes of tokens and special-tokens 1s defined later in this chapter 
Or in the next chapter in the discussion of expressions. 


Syntactic Rules Used in the Manual 


This manual employs a set of conventions to describe the structure of commands 
and other ICE-86A language forms. Items 1 and 2 below specify the use of class- 
names and tokens, respectively. The features of this notation system are as follows: 


l. 


A lower-case italicized entry in the description of a command is the class-name 
for a set or class of tokens. To create an actual operable command, you must 
enter a particular member of this class. A class-name never appears in an actual 
operable command. For example, the lower-case entry: } 


breakpoint-register 


means that the command will. accept any of the three tokens: BRO, BR1 or BR 
(BR means BRO and BR1). Classes of tokens that have generalized usage, such 
as the classes of reference keywords and command keywords, are explained and 
assigned class-names in this chapter. Additional classes of tokens that appear in 
the syntax descriptions of particular commands are explained in the discussion 
of semantics that accompanies those commands. 


An upper-case entry is a token that must be used literally as given. A valid 
abbreviation of that token may substitute for the full token as given. The token 
may be a command word, or it may be a particular member of a class of 
references. For example, the upper-case entry 


DEFINE 


is a command word that must be used as given unless abbreviated. The 
abbreviation DEF may be used 1 in place of DEFINE. As another example, the 
upper-case entry 


BR1 
means that breakpoint register 1 must be named as and where given. 


A single required entry is shown without any enclosures, whereas a single 
optional entry is denoted by enclosing | in oe For example, in the com- 
mand syntax 


STEP [FROM address] 


the token STEP is required. The significance of the brackets around the entry: 
FROM address means that its selection is optional in this command. 


Where only one entry must be selected from a menu of two or more entries, the 
choices for the required deed are denoted by enclosing them in braces. For 
example, 


race {FRAME | 


INSTRUCTION 


| sadicaias that FRAME or INSTRUCTION must be selected: the tokens TRACE 


and = are required as given. 
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5. Anoptional entry is enclosed in brackets [ |. For example, 
STEP [FROM address | 


means that the command word STEP is required but the clause FROM address 
is optional in this command. 


Where a choice exists for an optional entry, the choices are given in a vertical 
arrangement enclosed in brackets. For example, the command 


OF BYTE 

OF WORD 

OF SINTEGER 
OF INTEGER 
OF POINTER 
OF REAL 


means that DEFINE, symbol], =, and expr are required in this command and 
module-name is optional. The brackets around the vertical arrangement of 
memory type designators denotes that selection of a memory type designator is 
optional but only one designator may be selected per DEFINE command. 


DEFINE [module-name] symbol = expr 


6. A group of required inclusive choices is given in a vertical arrangement and 
enclosed in braces (___) followed by a repeat symbol (...). ‘‘Inclusive’’ means 
that more than one of the items can be entered in the same command, and items 
can appear in any order; no item can be entered more than once. The menu of 
inclusive items represents a required entry or entries. For example: 


READ 

WRITTEN 

INPUT 
match-status-list = OUTPUT | ae 

FETCHED 

HALT 

ACKNOWLEDGE 


This notation indicates that one or more items from the vertical list is required 
to specify a match-status-list. If more than one item is used, they can be in any 
order and must be separated by commas. | 


To complete the example: 
WRITTEN, HALT, READ, FETCHED 
is a valid match-status-list. 


7. A group of optional inclusive choices is given in a vertical arrangement and 
enclosed in brackets and followed by a repeat symbol (...). ‘‘Inclusive’’ means 
that more than one of the items can be entered in the same command, and the 
items can appear in any order; no item can be used more than once. The menu 
of inclusive items represents an optional entry or entries. For example: 


NOCODE 
LOAD path-name | NOSYMBOL 
| NOLINE 


This notation indicates that none, one, or more than one choice of NOCODE, 
NOSYMBOL, and/or NOLINE may be included in one LOAD command; if 
more than one Is used, the entries can be in any order. 


To complete the example: 
LOAD :F0:TEST NOSYMBOL NOCODE NOLINE 
is a valid command. 
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8. Where mutually exclusive entries can be shown on one line, - following 
shorthand notation can be used: 


SUFFIX =Y::0::Q::T::H 
This example is equivalent to 


9. Where an entry can be repeated indefinitely at the user’s option, the syntax 
is notated by enclosing the repeatable entry in brackets [ ] followed by an 
ellipsis ..... For example, 

operand |operator operand | ... 
indicates that operator operand can be repeated as many times as desired. 


Character Set 


The valid characters in the ICE-86A command language include upper and lower 
case alphabetic ASCII characters A through Z and the set of digits 0 through 9. The 
space serves as a delimiter for tokens, and carriage-return/line-feed characters are 
also valid, delimiting command lines. A question mark, ?, @ sign, and §$ sign are 
also valid in user-defined names entered in the command language. 


The algebraic operators + and — (binary and unary), the asterisk (*), and slash (/), 


relational operators (=, <, >), the ampersand, semicolon, colon, period, paren- 
theses, exclamation mark (!), pound sign (#), percent sign (Y%) and comma constitute 
the only other valid ASCII characters for the ICE-86A emulator. Non-printing 
characters are ignored; tabs, form feed, etc. are treated as spaces. Other characters 
are errors. 
alphabetic characters: 
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijkImnopaqrstuvwxyz@? 
numeric characters: 
0123456789(ABCDE F: hexadecimal characters) 
special characters: 


+-<=>$'&).(;*/#!:,% 


This character set is used to construct the vocabulary that constitutes the command 
language. 


Introduction to Tokens 


A token in ICE-86A command language is roughly equivalent to a ‘word’ in the 
English language. It consists of a string of alphanumeric characters that may be 
augmented by a one or two special character prefix that serves as a token identifier. 
Tokens are divided into the following types: keywords, user-names, and arepanal: 
tokens. Examples are: 7 


REGISTERS, .START, .. MODULE, .SAM, 0400, 123AH. 
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Keywords 


The ICE-86A emulator recognizes a general class of predefined tokens that are fixed 
in the command language. They provide two functions. Reference keywords are 
used to specify locations having unique predefined functions. Command keywords 
specify command type and subfunctions within a command. The following sections 
define and describe these keyword classes. Each class and associated keyword set is 
presented in the following paragraphs. Appendix A contains a listing of ICE-86A 
keywords and their abbreviations. 


The reason for discussing the various classes and subsets here is to smooth the later 
discussions of commands, where the class-names are used to show what elements 
may appear in specific commands. 


Reference Keywords 


The command language contains a set of system defined mnemonic tokens that are 
used to address system objects. Each device, such as the accumulator or a register, is 
assigned a specific mnemonic that is to be used to address and access the contents of 
that device. These identifiers are called reference keywords. Reference keywords are 
used in ICE-86A commands to refer to 8086 processor registers and flags, emulation 
registers, memory locations, and I/O ports. 


The total set of reference keywords is subdivided by types, each of which is refer- 
enced by aclass name. Class names are always shown in lower case italics. For exam- 
ple, the class name general-register denotes the set of four 16-bit general work 
registers in the 8086 processor. A reference token is assigned to each element within 
the given class and is always shown in upper case. For example, ‘RAX’ denotes the 
contents of the accumulator (RAX register) of the general register set. 


Registers 


The register structure contains three files of four 16-bit registers, a set of 
miscellaneous registers, and a set of four pseudo-registers. The three files of registers 
are the general register file, the pointer and index file, and the segment register file 
(see table 4-3). The miscellaneous set consists of the instruction pointer, flag 
register, CAUSE register, OPCODE register, PIP register, TIMER register, 
HTIMER register, and BUFFERSIZE register. The pseudo-register set consists of 
the breakpoint and trace point registers. The miscellaneous register set and the 
pseudo- registers provide a variety of functions to the ICE-86A emulator that are 
described in the appropriate command sections of this manual. The register struc- 
tures are described in the following paragraphs. 


Table 4-3. Classes of Hardware Elements 


general-register | 8-bit and 16-bit work register 


pointer-register 16-bit address register 
index-register 16-bit address register 
segment-register 16-bit segment reference register 
status-register | | _ 8-bit and 16-bit status registers 
emulation-register breakpoint and tracepoint registers 
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General Register File. The RAX, RBX, RCX, and RDX registers compose the 
General Register File. These registers participate interchangeably in 8086 arithmetic 
and logical operations. These registers are assigned the following mnemonics: 


RAX: Accumulator Note: These are the 8086 AX, BX, CX, DX 
RBX: Base Register registers (i.e., the ICE-86A emulator 
RCX: Count Register appends ‘R’ to the 8086 names). 


RDX: Data Register 


The general registers are unique within the 8086 as their upper and lower bytes are 
individually addressable. Thus, each of the general registers contains two 8-bit 
register files called the H file and L file as illustrated below. | 


RAX: 
RBX: 
RCX: 
RDX: 


Pointer and Index Register File 


Pointer and Index Register File. The BP, SP, SI, and DI registers are called the 
Pointer and Index Register File. The registers in this group are similar in that they 
generally contain offset addresses used for addressing within a segment. They can 
participate interchangeably in 16-bit arithmetic and logical operations and can also 
be used in address computation. The mnemonics associated with these registers are: 


SP: Stack Pointer 
BP: Base Pointer 
SI: Source Index 
DI: Destination Index 


The pointer and index registers are illustrated below. 


General Register File 


Segment Register File. The CS, DS, SS, and ES registers constitute the Segment 
Register File. These registers provide a significant function in the memory address- 
ing mechanisms of the 8086. They are similar in that they are used in all memory 


address computations. The mnemonics associated with these registers are: 


CS: Code Segment Register 
DS: Data Segment Register 

SS: Stack Segment Register 
ES: Extra Segment Register 
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The contents of the CS register define the current code segment. All instruction 
fetches are taken to be relative to CS using the instruction pointer (IP) as an offset. 


The contents of the DS register define the current data segment. All data references 
except those involving BP, SP, or DI in a string instruction are taken by default to 
be relative to DS. 


The contents of the SS register define the current stack segment. All data references 
which implicitly or explicitly involve SP or BP are taken by default to be relative 
to SS. 


The contents of the ES register define the current extra segment. The extra segment 
has no specific use, although it is usually treated as an additional data segment. 


The segment registers are illustrated below. 


Segment Register File 


Status Registers 


The instruction pointer, flag register, CAUSE register, OPCODE register, PIP 
register, TIMER register, HTIMER register, BUFFERSIZE register, UPPER 
register, and LOWER register constitute the status register set. These registers pro- 
vide a variety of functions to the emulator. These registers are assigned the following 
mnemonics: 


IP: Instruction Pointer (8086) 

~ RF: Flag Register (CE-86A emulator) 
CAUSE: CAUSE Register (ICE-86A emulator) 
OPCODE: OPCODE Register (ICE-86A emulator) 
PIP: Previous Instruction Register (ICE-86A emulator) 
TIMER: TIMER Register (ICE-86A emulator) 
HTIMER: HTIMER Register (ICE-86A emulator) 
BUFFERSIZE: BUFFERSIZE Register (ICE-86A emulator) 
UPPER: UPPER Register (ICE-86A emulator) 
LOWER: LOWER Register (ICE-86A emulator) 


The contents of the IP register define the offset to the CS register in instruction 
address computations. The Flag Register contains the status flag values in the same 
format as that pushed by the 8086 PUSHF instruction. The CAUSE register retains 
the cause of the last break in emulation and the OPCODE register stores the opcode 
fetched in the last instruction-fetch cycle in trace data. The Previous Instruction 
Register stores the displacement part of the address of the last instruction-fetch in 
trace data. TIMER contains the low-order 16 bits of the 2-MHz timer indicating 
how long emulation has run (read only). HTIMER contains the high-order 16 bits of 
the timer (read only). BUFFERSIZE contains the count (displayed in decimal only) 
of frames of valid trace data collected in the trace buffer (16 bit, read only). The 
UPPER register contains the highest address in ICE-86A workspace below the sym- 
bol table. The LOWER register contains the lowest address in ICE-86 workspace 
above the ICE-86A software. 


4-9 


Elements of the ICE-86A Command Language 


4-10 


The status registers are illustrated below. _- 


BUFFERSIZE: 
UPPER: 
LOWER: 


Status Registers 


The Flag Register contains nine status bits. The following mnemonics are assigned 
to each of the status values in the register: 


AFL: Auxiliary carry out of low byte to high byte 

CFL: Carry or borrow out of high bit 

DFL: Direction of string manipulation instruction 

IFL: Interrupt-enable (external) 

OFL: Overflow flag is signed arithmetic 

PFL: Parity 

SFL: Sign of the result of an operation 

TFL: Trap used to place processor in single step mode for debug 
ZFL: Zero indicates a zero value result of an instruction 


AFL is set if an instruction caused a carry out of bit 3 and into bit 4 of a resulting 
value. CFL is set if an instruction caused a carry or a borrow out of the high order 
bit. DFL controls the direction of the string manipulation instructions. IFL enables 
or disables external interrupts. OFL denotes an overflow condition in a signed 
arithmetic operation. SFL indicates the sign of the result of an operation. TFL 
places the processor in a single-step mode for program debugging. ZFL indicates a 
zero valued result of an instruction. The positions of the status bits in the RF 
Register are shown below. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


Flag Register 


The one byte CAUSE Register stores the cause for the last break in emulation. 


The byte returned by the ‘‘Read Break Cause’’ hardware command contains the. 


following bit values (if bit = 1, then the specified condition is true, otherwise false). 
Each bit has associated with it a message that is displayed if the bit 1 1s true when the 
software command CAUSE i is entered. 


Bit Position Condition | ~ Display 
0 Breakpoint 0 matched E ‘BRO’ 
1 Breakpoint 1 matched ‘BR1’ 
20 Both breakpoints matched sequentially EQS. 
3 Guarded memory access occurred eee ‘GUARD’ 
4 User aborted processing By ase ‘ABORT’ 
5 Timeout on user READY . ‘RDYTO’ 
6 Timeout on user HOLD ‘HLDTO’ 
7 


External break signal ‘EXTRN’ 
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BRO and BRI occur when emulation is halted due to matching the condition set in 
the corresponding break register. Use of the breakpoint registers is discussed in 
Chapter 6. SEQ occurs when emulation is halted due to matching both breakpoint 
registers during the same instruction. For example, BRO can be set for the address of 
an instruction while BRI is set for the value at that address, i.e., the instruction 
opcode. Then, when the specified instruction is fetched from the specified address, 
SEQ is the break condition displayed. GUARD occurs when memory that was NOT 
mapped is accessed. Memory mapping is discussed in Chapter 7. ABORT occurs 
when the user presses the escape key to halt emulation. RDYTO occurs when emula- 
tion is halted because of a ready timeout error. See Chapter.6 and Appendix B. 
HLDTO occurs when emulation is halted because of a hold timeout error. See 
Appendix B. EXTRN occurs when the user halts emulation through the external 
break line in the buffer box. See Chapter | for a description of this line. 


8086 Pin References 


The ICE-86A emulator provides access to eight 8086 pins. The pin names reference 
1-bit values. Pin names are read-only references only. The following mnemonics are 
assigned to reference the 8086 processor pins shown below. 


Mnemonic 8086 Pin Meaning 

RDY READY Acknowledgment from addressed memory or I/O 
device that it has completed data transfer. 

NMI NMI Non-maskable interrupt. 

TEST TEST Used by the wait-for-signal instruction for processor 
synchronization purposes. 

HOLD HOLD Request for local bus “‘hold”’. 

RST RESET Causes processor to immediately terminate present 
activity. 

MN MN/MX Specifies minimum/maximum configuration. 

IR INTR Maskable interrupt request. 

RQGT,BUS RQ/GTO, Request/Grant pin 

RQ/GT1 


(HOLD, HLDA) 


Emulation Registers 


The emulation registers consist of the breakpoint registers and the trace registers. 


Type Class Name Keywords 
Breakpoint register break-reg BRO, BR1, BR 
Trace point register trace-reg ONTRACE, 

OFFTRACE 
GO register go-reg GR 


The term break-reg is the class name for the two breakpoint registers used to halt 
emulation. The term trace-reg is the class name for the two registers that control 
tracing. The term go-reg refers to the GO-register, an ICE-86A pseudo-register that 
controls the breaking of real-time emulation. 


Command Keywords 


The command keywords specify command types and command functions to be exe- 
cuted. ICE-86A commands are of three major types: simple commands, compound 
commands, and macro commands. The following sections define the associated 
command formats and illustrate the use of keywords in each of the command types. 
Each of the formats is specified and illustrated by example using appropriate com- 
mand keywords. The full vocabulary of command keywords is presented following 
the command descriptions. 
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Simple Commands 

Simple commands are one of three types: 
e Set/change commands 

e Display commands 

e Execution commands 


The following sections describe the formats and provide examples of each of these 
simple commands. 


Set/Change Commands. The set/change commands have the following format: 


item-type [item-qualifier]... =new-setting 
where 
item-type A keyword or user name of an alterable element. 
item-qualifier A keyword, user name or value used to provide further 
specification of the particular element that is to be set or 
altered. 
new-setting The value that the specified item is to be set to. 
Examples: 


BRO = 1000H EXECUTED 
BYTE 10FFH = 3AH 
..MOD1 .SYMBA .SYMBB = 10FFH > 


Display Commands. The display commands have the following format: 


item-type |item-qualifier]... 


where 
item-type A keyword or user name of a displayable element or set 
of displayable elements. , 
item-qualifier A keyword, user name or value used to provide further 
specification of the particular element(s) to be 
displayed. 
Examples: 
BRO 
BYTE 10FFH 
..MOD1.SYMBA.SYMBB 
REGISTER 
RAX 
FLAG 
STACK 10 
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Execution Commands. The execution commands have the following format: 


commanda-verb |command-parameter]... 


where 


command-verb 


command-parameter 


Examples: 


GO 
GO FROM .START 


A command keyword that describes an action that is 


to be performed. 


Keywords that specify the objects of the action 


denoted by the command-verb. 


GO FROM .START TILL 1000H EXECUTED 


TRACE 
PRINT ALL 
PRINT 10 
MOVE —10 


Compound Commands 


Complete description of the formats of the compound commands and the use of 


keywords with these commands is contained in Chapter 8. 


Macro Commands 


Complete description of the formats of the macro commands and the use of 


keywords with these commands is contained in Chapter 8. 


Utility Command Keywords 


The Intel Systems Implementation Supervisor (ISIS-II) is the diskette operating 
system for the Intellec Microcomputer Development System. The ICE-86A emulator 
runs under ISIS-II control, and can call upon ISIS-II for file management functions 
through the utility commands. These commands employ the following command 


keywords: 


Keyword 
ICE86 
EXIT 
LIST 
LOAD 


NOCODE 
NOLINE 


NOSYMBOL 


SAVE 
SELECTING 


Function 


Commands the ICE-86A program to load from diskette. 
Commands control to be returned to ISIS-Il. 

Commands ICE-86A emulation output to be copied to printer or 
file. 

Commands user program to load into memory accessed by 
ICE-86A. 

A Modifier specifying that program code is not to be saved. 

A Modifier specifying that the line number table is not to be 
saved. | 
A Modifier specifying that the symbol table is not to be saved to 
diskette. 

Commands user program to be saved on an external device. 

A Modifier specifying that a range of modules whose symbols 
are to be LOADed is to follow. 
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Number Base and Radix Commands 


ICE-86A commands and displays involve several different number bases (radixes). 
This section describes the command keywords and radixes used to control the 
number base. | 


Keyword 7 Function 
BASE Set or display console output radix. 
SUFFIX Set or display console input radix. 
EVALUATE Commands a numeric constant or expression to be displayed 


in all five possible output radixes. 


H Hexadecimal (base 16). 
O Octal (base 8). 

Q Octal (base 8). 

T Decimal (base 10). 

Y Binary (base 2). 

ASCII ASCIl character code. 


Memory Mapping Command Keywords 


These commands display, declare, set or reset the ICE-86A memory mapping. The 
ICE-86A emulator uses these maps to determine what memory is installed on a pro- 
totype system and what memory resources are being ‘‘borrowed’’ from the Intellec 
system and the ICE emulator for testing purposes. These commands employ the 
following keywords: | 


Keyword Function 
DISK Maps logical memory segments into a diskette file. 
GUARDED Declares memory segments to be guarded. Accesses to 
addresses in these segments are error conditions. 
ICE | Maps memory segments into ICE ‘‘real-time’’ memory. 
INTELLEC Maps memory segments to expanded Intellec memory. 
MAP Commands the ICE-86A emulator to display, declare, set, or 
reset ICE-86A memory mapping. 
NOVERIFY Specifies that the normal read-after-write verification of data 
| loaded into memory be suppressed. 
RESET Resets the ICE-86A memory mapping. 
USER Maps logical segments into user’s prototype memory. 


Hardware Register Command Keywords 


This section presents the keywords used in the ICE-86A emulator to specify and 
modify hardware register commands. 


Keyword Function 
BUS Command keyword indicating that the current master of the 
bus isto follow. | 
CLOCK Command keyword indicating that a system clock specification 
3 is to follow. | : 
DISABLE Command keyword indicating that acommand function is to be 
| disabled. | | - 
ENABLE | Command keyword indicating that a command function is to be 
enabled. | ) 2 | 
ERROR Command modifier specifying that an error is to be reported 


whenever the command signal times out. 


~~ EXTERNAL ICE-86A is to operate from an external (user-provided) clock. — | 


ICE-86A 


ICE-86A 


FLAG 
HARDWARE 
INFINITE 
INTERNAL 
PIN 
REGISTER 


RQGT 


RWTIMEOUT 
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Contents of the 9 flags are to be displayed. 

Reset command modifier, causes a hardware reset. 

Set command signal timeout to “‘infinite,’’ disabling timeout. 
ICE-86A is to operate from an internal (8086-provided) clock. 
Contents of the six 8086-input pins are to be displayed. 
Contents of the thirteen 16-bit 8086 registers and RF are to be 
displayed. 

Command keyword indicating that the methods of handling 
requests for the bus in maximum mode is to be displayed or 
set. 

Used to enable or disable memory access timeout. 


Memory and Port Contents Command Keywords 


These commands give access to the content or current value stored in designated 
memory locations or input/output ports. | 


Keyword 


ABSOLUTE 
BASE 
BOOL 
BYTE 
INTEGER 
LENGTH 


DASM 


DREAL 
POINTER 
PORT 
REAL 
SINTEGER 
STACK 
TREAL 
WORD 
WPORT 


Function 


Display all addresses as 20-bit numbers. 

Display all addresses in base and displacement format. 

Display expression as a boolean value. 

1-byte, unsigned integer value. 

2-byte, unsigned integer value. 

Indicates that an integer value denoting the length of a partition 
is to follow. 

Indicates that a range of memory is to be disassembled into 
8086 assembly language mnemonics. 

8-byte, signed real value. 


4-byte, pointer value. 


Reference to 8-bit |/O ports. 

4-byte, signed real value. 

1-byte, signed integer value. 

Indicates that words from the user’s stack is to be displayed. 
10-byte, signed real value. 

2-byte, unsigned integer value. 

Reference to 16-bit 1/O ports. 


Symbol Table and Statement Number Table Command Keywords 


The ICE-86A emulator maintains a symbol table and source program statement 
number table to enable the user to refer to memory addresses and other values by 
using symbolic references and statement number references in ICE-86A commands. 
The following are command keywords contained in these commands: 


Keyword 


DEFINE 
DISABLE 
DOMAIN 


ENABLE 
LINE 


MODULE 

OF 
REMOVE 
SYMBOL 
SYMBOLICALLY 
TYPE 


Function 


Command keyword indicating a symbol is being defined. 
Command keyword used to disable a facility. 

Keyword used to establish a default module for source 
statement number references. 

Command keyword used to enable a facility. 

Specifies the display of all of the source statement number 
table. 

Specifies the display of all of the ICE-86A module table. 
Specifies that a memory type designation is to follow. 
Specifies that symbolic reference(s) is/are to be deleted. 
Specifies the display of the entire ICE-86A symbol table. 
Specifies the symbolic display of values. 

Indicates an assignment or change of memory type to a 
symbolic reference. 
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Emulation Control Command Keywords 


The emulation control commands permit the user to specify the starting address 
where emulation is to begin, and to specify and display the software or hardware 
conditions for halting emulation and returning control to the console for further 
commands. These commands employ the following keywords: 


Keyword : Function 


ACKNOWLEDGE 


Match on 8086 interrupt acknowledge. 


AND Indicates a match on both breakpoint registers required to halt 
3 emulation. 

DOWN Less than or equal to the referenced address. 

EXECUTED An instruction fetch out of the execution queue. 

FOREVER All break conditions disabled. 

FETCHED Memory read into the execution queue. 

FROM — Keyword introducing a starting address. 

GO Command keyword that starts emulation. 

HALT 8086 processor halt. 

INPUT 1/O port read. 

LOCATION Denotes the following constant or expression to be an 
address. 

OR Indicates that a match on either breakpoint register will halt 
emulation. 

OBJECT Indicates that a memory reference or typed memory reference 
is to follow. 

OUTPUT 1/O port write. 

READ Memory read. 

STEP Single-step emulation command. 

TILL A keyword introducing one or more match or halt conditions. 

UP Greater than or equal to the referenced address. 

USING Indicates that a segment register is to be specified. 

VALUE Denotes the following constant or expression to be a data 
value. 

WRITTEN Memory write. 


Trace Control Commands 


The trace control commands allow the user to display or change the match condition 
in either or both of two tracepoint registers and to establish a tracepoint to condi- 
tionally start trace collection and a tracepoint to stop collection. These commands 
employ the following keywords: 


Keyword Function 

ADDR low-order 16 address/data bits. 

ALL A function keyword indicating that the entire trace buffer 
contents are to be displayed. 

BHE Byte High Enable. 

CONDITIONALLY Indicates trace is to be turned on when ONTRACE matches and 
turned off when OFFTRACE matches. 

DMUX Type of frame. | 

EXTRADDR High-order 4 address bits (address frame) or 4 status bits (data 
frame). 

FRAME Indicates that a trace reference is to follow or that the trace 


buffer is to be displayed frame by frame. 

A function keyword indicating that data in the trace buffer is to 

be displayed ininstruction format. | 

MARK 7 Equal 1 if trace was turned off before current frame or if 
emulation broke before current frame. 


INSTRUCTION 
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MOVE Command keyword.moves the trace buffer pointer. 
NEWEST Moves trace buffer pointer to bottom of buffer. 
~ NOW Indicates trace setting for beginning of next emulation. 

OFF Indicates trace turned off. 

OLDEST Moves trace buffer pointer to top of buffer. 

ON Indicates trace turned on. 

PRINT Command keyword calling for a display of one or more entries 
from the trace data buffer. 

QDEPTH Queue depth. 

QSTS 2 queue status bits, QS1, QS0. 

STS 3 status bits S2/,S1/, SO/. 


TRACE Command keyword indicating that the mode of display for trace 
data is to be set. 


User Names 


The command language permits the programmer and operator to employ symbolic 
addressing through the use of user-generated tokens as opposed to system-generated 
tokens (keywords). The language permits four types of user names: symbols, 
module names, statement numbers and macro names (see Chapter 8). 


Symbols 


A symbol is a sequence of contiguous alphanumeric characters, prefixed by a period 
(.), that references a location in a symbol table. The symbo/ has two uses. The 
referenced table location always contains a number; it may be an address of an 
instruction or variable in a program module, or it may be used directly as a 
numerical value. In the first case, the symbol! is an alternative method of program 


addressing (symbolic as opposed to direct numeric addresses). In the second case, it | 


provides a method for storing and retrieving data values symbolically into/from the 
table itself. 


As an example, consider the symbol .BEGIN in module ..MAINLOOP. The entire 
reference to this occurrence of .BEGIN is: 


..MAINLOOP.BEGIN 
where 


the double period (..) designates MAINLOOP as a module-name and 
the single period (.) designates BEGIN as a symbol-name. 


Statement Numbers 


In the process of compiling a source module in DEBUG mode, the PL/M compiler 
generates a set of (Source) statement numbers, one for each source statement in the 
module. Each statement number is linked to the absolute address of the first 
instruction generated by the PL/M compiler for the associated source statement in 
the source program. Each compiled program will contain a table of statement 
numbers and absolute addresses. Items (addresses) in the table are referenced by 
entering the associated statement number. | 
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The form of reference is: 
module-name # decimat:1 0 
where 
# is the ‘number’ sign; this designates the efercnes as a statement number and 


decimal-10 is the (source) statement number (a numeric constant). The default 
suffix of decimal-10 is always decimal. 


For example, 

.. MAINLOOP#123 
#123 is statement number 123 in the source program ..MAINLOOP. This reference 
would obtain the address of the first instruction generated by source statement 123 


of module ..MAINLOOP. 


Statement numbers are an alternative to program addressing, as opposed to labels in 
the program. 


Special Tokens 


The command language contains two special token sets that provide special func- 
tions: operators and punctuation. : 


Operators 
Type | Class Name | Operators 
relational rel-op =<,>,<=,< >,>= 
plus plus-op + ,-—, (binary and unary) 
mult multi-op » *_/, MOD 
logical log-op ~ NOT, AND, OR, XOR 
Punctuation 
Type Class Name Punctuation Characters 


punctuation punct-op "RLS I(SCRLFSP%#.. I! 


The use of punctuation characters are defined in those sections that define command 
formats. | 


Entering Commands at the Console — 


The ICE-86A emulator displays an asterisk prompt @) at t the left margin when it is 
ready to accepta command from the console. 


Each command is entered as a command line, which consists of one or more input 


lines; the length of an input line is limited to the number of characters that one line . 


of the console display can contain. 
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The ICE-86A emulator recognizes the carriage return as the terminator for a com- 
mand line. If it is necessary to use more than one input line to enter a command, 
each intermediate input line should end with an ampersand (&). When the ICE-86A 
emulator encounters the ampersand, it suppresses the interpretation of the com- 
mand that would occur on encountering the carriage return that follows. After the 
carriage return is executed, the ICE-86A emulator displays a double asterisk prompt 
(**) to acknowledge the continuation of the command line. 


Tokens in the command are separated by blanks, unless the construct requires 
another form of separator. For example, tokens in a list are separated by commas; 
in this case, blanks (spaces) may be inserted for clarity but are not required. 


Any input line may include comments. The comments which are preceded by a 
semicolon (;) must appear after any portion of the command that is on that input 
line; in other words, if the first character in an input line is a semicolon (;), the entire 
input line must consist of comments. Characters in a comment are not interpreted by 
the ICE-86A emulator and are not stored internally except in a DEFINE MACRO 
command. The main use of comments is to document an emulation session while it 
is in progress. 


Comments may not be continued from input line to input line. If an ampersand is 
used to continue a command line that also contains comments, the ampersand must 
come before the comment. An ampersand that is embedded in a comment is ignored 
by the ICE-86A emulator. 


You can use ISIS-II editing capabilities to correct errors in the current input line. 
The line-editing characters are as follows: 


Characters Result 
RUBOUT Delete last character entered in input line. The deleted 


character is echoed immediately. The RUBOUT . func- 
tion can be repeated, deleting one character each time it 


is pressed. 

CTRL X Delete entire input line. (CRTL Z gives the same result.) 

CTRLR Display entire input line as entered so far. This is useful 
after a RUBOUT, to review which characters have been . 
deleted. 

ESC Cancel entire command being entered. 

CRTL P Input next character literally. 

Carriage Return Terminate input line or command line. 

Line Feed Terminate input line 


Once a line terminator (carriage return or line feed) has been entered, that line can 
no longer be edited. 


The dollar sign ($) is ignored by the ICE-86A emulator in identifiers. You can use it 
as a separator when you want to combine two words into one token. For example, 
suppose you wanted to combine the two system groups DATA and STS into one 
symbol for your use. Instead of DATAANDSTS, you can use the § character as a 
separator: DATA$ANDS$STS. 


CHAPTER 5 


EXPRESSIONS 


An expression is a formula that evaluates to a number. The formula can contain 
Operands, operators, and parentheses. Expressions and operands appear in the 
ICE-86A emulator as command arguments to specify numeric values or boolean 
conditions. Depending on the command context, the resulting number is interpreted 
either as a numeric value or as a logical state (TRUE/FALSE). All expressions and 
operands represent one of the following: 


e Pointer: a pair of 16-bit unsigned integers. One integer is called the base (b) and 
the other integer is called the displacement (d). This manual uses the 
notation b:d to denote a pointer with a base b and displacement d. 
The ‘:’ operator is a base-displacement integer connector (see table 
5-3). Pointers may be used as memory addresses; then the 20-bit 
absolute address is 16*6 +d. 


e Integer: a single 16-bit unsigned integer treated modulo 65536. This is a special 
case of a pointer, with the base value equal to 0. 


_ The ICE-86A emulator provides only unsigned-integer arithmetic on pointers and 
integers. The arithmetic operations are always applied separately to bases and 
displacements (i.e., integer arithmetic is always 16-bit and is always done on the ‘d’ 
portion of ‘b:d’ address). Signed arithmetic is not provided. There are no arithmetic 
operators for REAL, TREAL, or DREAL types. REAL, DREAL, and TREAL 
cannot be EVALuated. 


A few examples are all that is necessary to illustrate the concept of expressions. 


1. The simplest form of an expression is a single value. That is, an expression that 
contains only one operand and no operators or parentheses: 


3 
FFFFH 
127Q 


2. The following expressions contain both operands and operators: 


2+3- 
1001110011101111Y — 101Y 
127/44 

0100:00FFH 


3. The following expressions contain operands, operators and parentheses: 


2* (6 + 4) 
(127 + 44)/20 


4. The use of symbols to reference numeric values represents a significant 
capability of the ICE-86A emulator. The following examples illustrate the use 
of symbols in expressions: 


.SYMBA OR .SYMBC 
(!VAR1 + 10)/(IVAR2— .SYMBD) 


This introduction to expressions is sufficient for the first reading of this manual or if 
the reader has familiarity with previous ICE products. Therefore, you may skip the 
remainder of this chapter and read the remaining chapters using the examples to 
gain further familiarity with the use of expressions in ICE-86A commands. The 
remainder of this chapter describes how expressions are constructed by representing 
the types of operands and operators that can be used, and provides the rules and 
some examples to explain how expressions are evaluated. The chapter also describes 
numeric and logical (boolean) command contexts, and gives a condensed syntax 
‘summary for expressions. 
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Operands 


All operands are composed of either pointers or unsigned integers. Operands can be 
cece by any of the following references: 


numeric constant 


-@ masked constant 


e keyword reference 

¢ symbolic reference — 

e statement number reference 
¢ memory reference 

e typed memory reference 

e port reference 

e string 

e (expression) 


The following paragraphs define sad explain each of the above operand types and 
formats. 


Numeric Constants 


A numeric constant produces a 16-bit integer value and is specified by a sequence 
composed of decimal digits and the letters ‘‘A’’ through ‘‘F’’ (hexadecimal digits), 
and, optionally, a suffix to specify explicitly the constant’s radix: 

numeric-constant = digit ... [suffix] 


Where: 


igh =O. ti 2c3gc 4 gceccB Gu AC BOC ODI ECE 


And: 


suffix =H: Ti: 0::Q::Y 


In the absence of a suffix, the default input radix for the current context is used. In 


most cases this is the radix set by the SUFFIX command; however, some commands 
may default their parameters to other radices. The allowed radices and their suffixes 
are: hexadecimal (‘‘H’’), decimal (‘‘T’’), octal (‘‘O”’ or ‘‘Q’’), and binary (‘‘Y’’). 
The radix determines which characters are valid in the constant. Numeric constants 
represent fixed unsigned integer values. The elements of numeric constants are sum- 
marized in table 5-1. 


Examples: 


1001111010100111Y 
1234 
1974T 
A2EH 

—177Q 
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Table 5-1. Elements of Numeric Constants 


Binary (base 2) 1100111010110101Y 
Octal (base 8) 7 4726Q 


Decimal (base 10) , 397T 


Hexadecimal (base 16) -9,A- OOFE3H 


(multiple of 1024) 64 


A numeric constant entered through the console with an explicit radix is interpreted 
accordingly. If it contains any digits that are invalid for that radix, an error results. 


A numeric constant entered from the console without an explicit radix is interpreted 
according to the implicit radix that applies to the context. In most contexts, the 
implicit radix is initially hexadecimal (H); in these contexts, the implicit radix can be 
set to Y, Q, O, T or H by using the SUFFIX command. 


Masked Constants 


A masked constant is syntactically identical to a numeric constant except it may not 
contain the ‘‘T’’ suffix and must contain one or more ‘‘X’’ characters. Each ‘‘X”’ 
character represents a ‘don’t care’ digit (1, 3, or 4 bits depending upon whether the 
radix is binary, octal, or hexadecimal). The radix, either explicit or implicit (i.e., 
previously specified), must be binary, octal or hexadecimal. The following are 
examples of masked constants : 


10X1X01Y (binary -2 don’t care bits shown explicitly) 

3X4Q (octal - 3 don’t care bits implicit because each octal 
numeral represents 3 bits; equivalent to OLIXXXI100Y) 

6FX1H (hexadecimal - 4 don’t care bits, implicit because each 
hexadecimal numeral represents 4 bits; equivalent to 
01101111X%XX0001 Y) 


Keyword References 


Keyword references are used to gain access to all of the system variables, including 
registers, status flags, input pins, and status information. When one is used in a 
command, the value returned is a 16-bit integer and is the current contents of the 
referenced object. Thus indirection through referenced variables is obtained. The 
values of system variables may be used in boolean conditions in control structures. 
A keyword reference may reference a value less than 16 bits. If the keyword 
reference returns a value of less than 16 bits, the value is coerced to 16 bits by right- 
justifying it and filling the high-order bits with zeroes. (Refer to Chapter 4 for a 
listing and description of reference keywords.) 


Examples: 
SP =SP-2 (decrement the contents of the Stack Pointer) 
RAX (display the contents of the Accumulator) 
TIMER (display the contents of the TIMER register) 


AFL OR OFL (““OR” Auxiliary-carry and Overflow flags) 
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Symbolic References 


A symbolic reference points to an entry in the ICE-86A symbol table. Correspond- 
ing to each symbol table entry is a pointer value that represents an address or a con- 
stant. When a symbol reference is entered as an operand, its corresponding value is 
obtained from the referenced table location and used in the associated expression. A 
symbolic reference is specified in the following format: 


symbolic-ref = {module-ref] symbol ... 


Module references and symbols are both user-assigned. Module names are LOADed 
with a program—they cannot be assigned from the ICE-86A emulator. Most sym- 
bols are also LOADed. The module name identifies a particular symbol table that 
contains the symbols associated with a particular program module. The symbol 
table contains the symbols that are used by that program. Module names and sym- 
bols are composed of user names and identifying prefixes. User names are composed 
of character strings where each character may be an alphabetic character, digit, 
**@,’’ underscore (__), dollar sign ($), or ‘‘?’’ with the exception that the first 
character in the string may not be a digit. The module name is prefixed by a double 
period (‘‘..’’): 


module-ref = Resins | 

A symbol is identified by a single period prefix (‘‘.’’): 
symbol = .symbol-name 

Therefore the format for a symbolic reference can be shown as follows: 
symbolic-ref = |..module-name| .symbol-name... 


If a module name is present, then only the referenced module’s symbol table is 
searched; otherwise all of the current symbol table is scanned for the referenced 
symbol. If more that one symbol is referenced, the symbol table is scanned for the 
occurrence of the first symbol in the list. Then the table is scanned for the first 
occurrence of the second symbol following the entry for the first symbol. This is 
repeated in sequence for all the symbols in the list. The value returned is the pointer 
containing the base and displacement address values for the entry specified by the 
symbolic reference. 


The use of the symbol table provides you with considerable freedom in referencing 
and retrieving user variables. The ability to assign symbolic names to variables, pro- 
cedures, and module names allows you to assign them names that can be associated 
with their functions and interrelations within the program. For example, assume 
that the symbol .X represents a variable that is used in procedures PROCX, 
PROCY, and PROCZ of module MODABLE. Then the value of variable X in 
PROCY can be retrieved with the following symbolic reference: 


.. MODABLE.PROCY.X 
whereas the value of variable X in PROCZ is obtained by: 


..MODABLE.PROCZ.X 


Statement Number Reference 


A statement number reference points to the address of the first instruction generated 
by the compiler for the source statement specified by the associated statement 


number. Statement number information for each compiled program module is © 
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stored in its statement number table. Therefore program locations can be referenced 
symbolically via statement number. The LINK process can combine different 
modules, each with its own set of statement numbers. Therefore, a statement 
number reference may require a module reference in the same format as that used in 
a symbolic reference. A statement number reference uses the following format: 


source-statement-ref = |..module-name | # statement-number 


The statement number is an integer value that specifies the number of the source 
Statement. If the statement number does not have an explicit suffix, the default 
suffix is decimal. If more than one program module is currently loaded into 
ICE-86A memory, a module reference is required to distinguish the reference from 
identical reference numbers in other modules. Examples are: 


#45 
.. TEST1 #12FH 


The value returned is a pointer value that is the absolute address of the first instruc- 
tion generated by the compiler for the source statement referenced by the statement 
number. : 


Memory References 


References to memory specify the type of reference as well as the memory location 
(address) required. A memory reference uses the following format: 


memory-ref=reference-type address 


reference-type Definition 

BYTE 1-byte integer value at location ‘‘address’’. 

WORD 2-byte integer value with low byte at ‘‘address’’ and high byte at 
‘‘address”’ + 1. 

SINTEGER came as BYTE. 

INTEGER Same as WORD. 

POINTER 4-byte pointer value located at ‘‘address’’ through ‘‘address’’ + 3. 

REAL 4-byte real value located at ‘‘address’’ through ‘‘address’’ + 3. 

DREAL 8-byte real value located at ‘‘address”’ through ‘‘address’’ + 7. 

TREAL 10-byte real value located at ‘‘address’’ through ‘‘address’”’ + 9. 


When changing memory or referencing it in an expression, BYTE is equivalent to 
SINTEGER and WORD to INTEGER. However, when displaying memory, the 
format of the display is either unsigned (BYTE, WORD) or signed (SINTEGER, 
INTEGER, REAL, DREAL, TREAL). (See Display Memory command, 
Chapter 7.) : 


Examples: 


BYTE 1000H 

BYT 0100:0000H 
WORD 101 
INTEGER .ABLE 
POINTER CS:IP 
REAL 0110:1000H 
REAL 1000H 
DREAL 1000 LEN 4 
TREAL 100:10 
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Typed Memory Reference 


A typed memory reference employs the symbols contained in the ICE-86A symbol 
table to obtain both location and type of memory reference. Each symbol has one of 
the following types of memory references or has no type: 


BYTE 1-byte integer value 
WORD 2-byte integer value 
SINTEGER Same as BYTE. 
INTEGER Same as WORD 
POINTER 4-byte pointer value 
REAL 4-byte real value 
DREAL 8-byte real value 
TREAL 10-byte real value 


If asymbol has a memory reference type, the symbol represents a memory reference. 
If the symbol has no memory reference type, the symbol represents a label, pro- 
cedure name, or a constant. If the source language translator generates type 
information in the object file, then the type values are loaded with the symbols in the 
ICE-86A emulator. The user may also specify memory reference type when defining 
symbols or when using the ICE-86A TYPE command. | 


A typed memory reference is executed with the following format: 
typed-mem-ref = |!!module-name | '!symbol-name ... 
Example: 


Assume module table ..SAM contains: 


Symbol Type Base Value Displacement Value 
X BYTE | 100H 0 
LY WORD 100H 0 
iL POINTER | 100H 0 
.R REAL 100H 0 
.D DREAL 100H 0 
T TREAL 100H 0 


Also assume: 


Memory Location Content 
~1000H © 21 
1001H 43 
1002H 65 
1003H 87 
1004H 54 
1005H 32 
1006H | 12 
1007H 89 
1008H 75 
1009H 47 
Therefore: 
IISAM !X = 21 
IISAM TY = 4321 


ISAM !Z = 8765:4321 
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NSAM !R = 1.72477726E-34 
ISAM !D = 5.6433128615079697E-—265 
ISAM !T = 9.931 79129344306291E + 574 


Port References 


The ICE-86A emulator supports a maximum of 64K 8-bit or 32K 16-bit I/O ports. 
These ports are referenced in the following format: 


port-ref =PORT address ::WPORT address 


PORT references an 8-bit I/O port at location ‘‘address’’. WPORT references a 
16-bit I/O port at location ‘‘address’’. The value of ‘‘address’’ must be an integer. 
The port is read or written immediately when referenced. 


Examples: 


PORT 123 
PORT RDX 
WPORT 1FFH 


String Constants 


Any one of the ASCII characters (ASCII codes 00H through 7FH) can be entered as 
a string constant by enclosing the character in single quotes. The operand value of a 
string constant is a 16-bit integer with the high-order bits set to 0, and the 7-bit 
ASCII code in the low-order seven bits. For example, the string constant ‘A’ has the 
value 0000000001000001 Y (0041H). 


In data communications usage, an ASCII-coded character consists of seven low- 
order data bits (bits 0-6), and a parity bit (bit 7). Thus another way to describe the 
operand value of an ASCII string constant is as a two-byte integer; the high byte is 
all zeros and the low byte contains the 8-bit ASCII value with the parity bit set to 0. 


Table 5-2 gives the printing ASCII characters with their corresponding hexadecimal 
codes (codes 20H through 7EH). Note that some console keyboards output upper 
case ASCII characters only, or lack keys for some of the non-printing ASCII codes. 


Parenthesized Expressions 


(exp): an operand whose value is the value of the parenthesized expression, e.g., 
(1+2+3) = 6 (operand value). 


Operators 


An expression can contain any combination of unary and binary operators. Table 
5-3 describes all the operators available under the ICE-86A emulator. The operators 
are ranked in order of precedence from highest (1) to lowest (10). Other things being 
equal, the operator with the highest precedence is evaluated first. The operators are 
shown in the table as they are to be entered in expressions. The class content- 
operators has too many details to fit the table; see table 5-5. The table identifies each 


Operator as unary or binary. A unary operator takes one operand, and a binary 


operator takes two operands. 
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Table 5-2. ASCII Printing Characters and CODES (20H—7EH) 


Brees (SP) 
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OCOnNONR WMO" O~: 


a 
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ab 


Classes of Operators 


For discussion, the operators are classed as shown in table 5-4. Table 5-6 specifies 
the arithmetic and logical semantic rules for operators. 


Arithmetic Operators 


The ICE scanner distinguishes unary ‘‘+’’ and ‘‘—’’ from binary ‘‘+’’ and ‘‘—’’ by 
context. Unary ‘‘+’’ is superfluous, since it is a no-operation. 

A unary ‘‘—’’ applied to an integer means ‘‘2’s complement modulo 65536’’. In 
other words, (—N) evaluates to (65536 — N). As the ICE-86A emulator uses only 
unsigned arithmetic, unary ‘‘—’’ does not apply to pointers. The unary ‘‘—’’ is also 
used in the MOVE and PRINT commands (see MOVE and PRINT commands in 
Chapter 6). 


Binary ‘‘+’’ applies to pointer and integer values only and results in the arithmetic 
sum of its two operands. In the case of the sum of two integers, the result is treated 
modulo 65536 (any high-order bits after the sixteenth bit are dropped). In the case of 
the sum of a pointer and an integer, the displacement value of the pointer is summed 
with the integer modulo 65536 and the base value of the pointer is unchanged. 


Binary ‘‘—’’ applies to pointer and integer values only and results in the arithmetic 
difference of the two operands. In the case of the difference of two integers, the 
result is the 2’s complement difference of the two integers; this result is also treated 
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modulo 65536, so that a ‘‘negative’’ result (-N) ends up as (65536 — N). An integer 
may also be subtracted from a pointer. In this case, the result is the 2’s complement 
difference of the pointer displacement and the integer modulo 65536 and the base 
value of the pointer remains unchanged. The ‘‘—’’ can be used to obtain the 
arithmetic difference of two pointers but only if they have the same base value. In 
this case the result is the 2’s complement difference of the displacements modulo 
65536 and the resulting base value is set equal to zero. An error occurs if the base 
values of the pointers are not equal. 


The operators ‘‘*’’, **/’’, ‘“*MOD’’, and ‘‘MASK’”’ can be applied only to integer 
operands and return only integer results. 


Binary ‘‘*’’ results in the multiplication of two integer operands, truncated to the 
low-order 16 bits. 


Binary ‘‘/’’ causes the first integer operand to be divided by the second. The result is 
the integer quotient; the remainder, if any, is lost. Thus, (5/3) evaluates to (1). 


Binary ‘‘MOD”’ returns the remainder after integer division as an integer result, and 
the quotient part of the division is lost. Thus, (5S MOD 3) evaluates to (2), the 
remainder of (5/3). 


Binary ‘‘MASK’’ performs a bitwise logical AND on two integer operands. If both 
are 1’s, the result has | in that bit; otherwise the result has 0 in that bit. MASK is 
identical to the boolean ‘‘AND’’ operator, except that MASK -has_ higher 
precedence. | 


, SEGMENT, OFFSET have the highest precedence of the arithmetic operators. 
Binary ‘‘*’’, ‘‘/’’, and ‘‘MOD’’ have equal precedence, lower than unary ‘‘— 
Binary ‘‘+’’ and ‘‘—’’ have equal precedence, lower than ‘‘*’’, ‘‘/’’, and ‘‘MOD’’. 
**MASK’’ has lowest precedence of the arithmetic operators (see table 5-3). 


Table 5-3. ICE™ Operators 


Ce ld 
Binary 


Base, displacement integer connector for a pointer 
(e.g., 1234:5678 or CS: IP). 


OFFSET Designates integer value that is the displacement of a 
pointer (e.g., OFFSET 1234:5678 is 5678). 


SEGMENT Designates integer value that is the base of a pointer 
(e.g., SEGMENT 1234:5678 is 1234). 


Unary plus. 

Unary minus, (-—N) means (65536-N), the 2’s 
complement of N, modulo 2'* 

Integer multiplication. 


Integer division. The result is the integer quotient; 
the remainder (if any) is lost. 


Modulo reduction. The remainder after division, 
expressed as an integer. 


Addition. 
Subtraction. 


MASK Bitwise AND. Higher precedence than _ identical 
| operation AND (see below). 


content- Treats operand as memory or port address, returns 
operator* | the content of that address. 
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Table 5-3. ICE™ Operators (Cont’d.) 


Unary — 
Binary? 


Is 
| (0) 
| Is greater than. Result is TRUE or FALSE. 

_ | Is less than. Result is TRUE or FALSE. 

Is not equal to. Result is TRUE or FALSE. 

Is greater than or equal to. Result is TRUE or FALSE. 
} Is less than or equal to. Result is TRUE or FALSE. 


equal to. Result is either TRUE (FFFFH) or FALSE — 


| Unary Logical (1’s) complement. Bitwise 1 becomes 
0, 0 becomes 1; TRUE becomes FALSE, FALSE 
becomes TRUE. 


Bitwise AND. If both corresponding bits are 1’s, 
| result has 1 in that bit; else 0. TRUE AND TRUE yields | 
a TRUE result; any other combination is FALSE. 


Bitwise inclusive OR. lf e/ther corresponding bit is a 
1, result has 1 in that bit; else 0. If either operand is 
TRUE, result is TRUE; else FALSE. 


Bitwise exclusive OR. If corresponding bits are 
different, result has 1 in that bit; else 0. If one operand 
is TRUE and the other is FALSE, result is TRUE; if 
both are TRUE or both are FALSE, result is FALSE. 


NOTES: | | 
14 = highest precedence (evaluated first), 10 = lowest precedence. 
2u = unary, b= binary. 

- 3Refer to text for additional details. 


4content-operator is one of the tokens BYTE, WORD, SINTEGER, INTEGER, POINTER, 
REAL, PORT, or WPORT. 


Table 5-4. Classes of Operators 


(Numeric) 
Arithmetic | 
_ unary : +,-, SEGMENT OFFSET, 
binary | * /, MOD, +, -—, MASK, : 


Content | 
unary content-operators 


(Boolean) 
Relational | 
— binary | =>, <, <>, P=, <S 
Logical | ae | 
unary NOT 
binary . AND, OR, XOR 


Unary | - +, —, SEGMENT, OFFSET, 
; content-operators, 
NOT , : 


Binary : | */,MOD, +, -, MASK, :, 
: : on Oa _ relational-operators, — 
AND, OR, XOR 
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Content Operators 


Content operators are keywords that refer to the contents of memory locations and 
I/O ports. In expressions, they function as unary operators with precedence 
immediately below ‘‘MASK’’. Table 5-5 summarizes the content operators for 
the ICE-86A emulator. 


Table 5-5. Content Operators 


Content Returned 


BYTE 1-byte integer value from the addressed location in memory. 

WORD © 2-byte integer value from the addressed location in memory. 
SINTEGER Same as BYTE. 

INTEGER Same as WORD. 

POINTER 4-byte pointer value from the addressed location in memory. 

PORT 1-byte value from addressed 8-bit I/O port. 

WPORT 2-byte value from addressed 16-bit !/O port. 

REAL 4-byte floating point number from the addressed location in memory. 


DREAL 8-byte floating point number from the addressed location in memory. 


TREAL 10-byte floating point number from the addressed location in 
memory. | 


To be used in an expression, a content operator must precede a single operand that 
can be interpreted as a valid address. A partition of addresses (using a keyword such 
as TO or LENGTH) cannot be used in an expression. Furthermore, the address 
given must be accessible (not GUARDED) if it uses the memory map (see MAP 
commands in Chapter 7). 


Relational Operators 


A relational operator calls for a comparison of the values of its two operands. The 
six possible relational operations are shown in table 5-4. Each comparison is either 
true when the expression is evaluated, or it is false. The result is correspondingly 
TRUE (FFFFH) or FALSE (0). 


Logical Operators 


The ‘‘NOT”’ logical operator results in a 1’s complement of an operand; a 16-bit 
operand is assumed. The following are examples of ‘“NOT”’ logical operations: © 


Operand Operation Result 
0 NOT FFFFH 
1 NOT FFFEH 
11110110 NOT 1111111100001001Y 
FFFFH NOT | 0 


FFFEH NOT 1 
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ANDing two operands results in the following values depending upon bit pair 


values: 


bit1 bit2 Result 


0 0 0 
0 1 0 
1 0 0 
1 1 1 
Examples: 


Logical Operation 


0 AND 0 

1010Y AND 1001Y 
FFFFH ANDO 
FFFFH AND FFFFH 
1 AND 0 


ORing two operands results in the following values depending upon bit pair values: 


bit1 bit2 Result 


0 oO 0 
0 1 1 
1 0 1 
1 1 1 
Examples: 


Logical Operation 


0ORO 
10R0 

1010Y OR 1001Y 
FFFFH ORO 
FFFFH OR FFFFH 


The result of an ‘‘XOR’’ operation is as follows: 


bit1 bit2 Result 


0 0 0 
0 1 1 
1 0 1 
1 1 0 
Examples: 


Logical Operation 


0 XOR0 

1XOR0 
1010Y XOR 1001Y 
FFFFH XOR0 
FFFFH XOR FFFFH 


Result 


Result 


0 

1 
1011Y 
FFFFH 
FFFFH 


Result 
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Arithmetic and Logical Semantic Rules 


Table 5-6 provides a summary of the semantic rules that apply to arithmetic and 
logical operations. The table specifies the function performed by each type of 
arithmetic and logical operation, the input required, and the result of the operation 


(output). 


logical 
not 


relational 


arithmetic 


memory- 
content 


memory- 
content 


1/0- 
content 


| +(binary) 


~(binary) 


~(unary) 
+(unary) 
override 
base/ 
construct 


pointer 


offset 


segment 


Table 5-6. Arithmetic and Logical Semantic Rules 


a 


AND, OR, XOR, MASK 
NOT 


47,44, 2=, 09, = 


*,1,MOD 


BYTE, WORD, INTEGER, 
SINTEGER 


POINTER 


PORT, WPORT 


OFFSET 


SEGMENT 


2 integers 
integer 
(1) 2 pointers, same 


base 
(2) 2integers 


2 integers 


pointer or 
integer 


pointer or 
integer 


integer 
(1) pointer, integer 
(2)integer, integer 
(1) 2 pointers with 
= base values 
(2) pointer & 
integer 
integer 
Alltypes 


(1) integer & pointer 


(2) 2 integers 
pointer 


pointer 


integer 
integer 
integer 


integer 


integer 


integer 


pointer 


integer 
pointer 
integer 
integer 


pointer 


integer 
same 
pointer 


pointer 


integer 


integer 


Bitwise conjunction or disjunction of integers. 
One’s complement of an integer. 


Logical test of relational expression. If the displace- 
ment integer values satisfy relational operation (true), 
then the output integer value = FFFFH. If the displace- 
ment integer values do not satisfy the realtional opera- 
tion (false), the output integer = 0. If the base values of 
the input pointers are not equal, an error occurs. 


Unsigned product (*), quotient(/), or remainder(MOD) 
of two integers. 


Fetches content of memory location addressed by 


input value. 


Fetches content of memory location addressed by 
input value. 


Fetches content of I/O port (8-bit or 16-bit) addressed 


by input value. 


Sum of the displacement values, same base as the 
pointer. Sum of the integers. 


Two’s complement difference of displacement values. 
Error occurs if base values are unequal. 

Two’s complement difference of pointer displacement 
value and integer input, same base as the pointer. 


| Two’s complement of the input integer. 


No change. 
e 


Replaces current base value of pointer with input 
integer value. 

Constructs new pointer with base value set to first 
input integer value and displacement set to second 
integer. | 
Generates integer value whose value is the displace- 
ment value of the input pointer. 


Generates integer whose value is the base value of the 
input pointer. — 
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How Expressions are Evaluated 


This section provides: a simple conceptual model of how the ICE-86A emulator 
evaluates an expression. The model involves a loop that scans the Ce 
iteratively (figure 5-1). The loop terminates in either of two ways: 


crtblthe expression resolves to a single numeric value. 
e When a syntax error (or other error) occurs. 


The ICE-86A emulator goes through the scan loop once for each operator in the 
expression. On each scan, the operator (unary or binary) that must be applied next is 
identified. 


The next operator is always: 

e the leftmost operator 

e with highest precedence (table 5-3) 

e that is enclosed in the innermost pair of parentheses. 


If this next operator is unary and has a numeric operand, the operation is performed 
on the operand to produce a numeric result. If the next operator is binary and has a 
pair of operands, the operation is performed on the pair of operands to produce a 
numeric result. If the next operator does not have the required number of numeric 
operands, a syntax error results, and the loop terminates. 


A pair of parentheses is ‘‘cleared’’ when it contains just a single numeric value; 
that is: 


(numeric-value) > numeric-value 


After performing any operation, the numeric result becomes an operand for the next 
scan. Parentheses are cleared before the next scan begins. 


“Case Studies”’ in Evaluating Expressions 


Here are some representative cases of expressions showing how they are evaluated 
by the ICE-86A emulator. In some examples, the steps in evaluation are shown, but 
most show just the overall result. Table 5-7 summarizes the cases. The EVALUATE 
(EVA) command used in these examples performs the evaluation and displays the 
result in the four numeric radixes (Y, Q, T, and H), plus the ASCII printing 
equivalent (if any) in single quotes. The examples in this section assume the initial 
conditions shown in table 5-8. This table also describes the special notation used in 
some of the examples. The examples also assume SUFFIX = T; that is, any number 
without an explicit radix is decimal. 


Case 1: EVALUATE operand 


An expression can be composed of just a single operand, requiring at most a lookup 
to produce a numeric result: 


Examples: 


*EVA 10 : 
1010¥ 12Q 10T AH ° 


*EVAIP 4 eee | : 
—1000000000000¥ 10000Q 4096T 1000H °’ 
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RESOLVE ALL 
PRIMARIES TO 
NUMBERS 


ANY 
MORE 
OPERATORS 


FIND INNERMOST 
PARENTHESES 


IDENTIFY OPERATORS 
WITH HIGHEST 
PRECEDENCE 


SELECT LEFTMOST 
SUCH OPERATOR 


“REQUIRED 
NUMBER OF 
OPERANDS 


EACH 
OPERAND IS 
A NUMBER 


MOR 
OPERATORS IN 
THESE PAREN- 
THESES 


CLEAR INNERMOST 
PARENTHESES 


Figure 5-1. A Simple Model of Evaluation 
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*EVA AA 
10000000000000Y 200000 8192T 2000H ‘’ 


*EVA 1234:5678H 
1234:5678H 179B8H 


Case 2: EVALUATE unary-operator operand 
A unary operator with a single primary operand evaluates to a number. 
Examples: 


*EVA -2 
1114111999111110Y 17776Q 65534T FFFEH ‘t’ 


“EVA BYTE .AA 
100011¥Y 438Q 35T 23H ‘# 


*EVA NOT IP 
1910114111111111Y 167777Q 61439T EFFFH ‘0’ 


Table 5-7. Representative Cases of Expressions 


Result of Lookup 


operand None number 
unary-operator operand Any number 
operand binary-operator operand Any number 


operand b1 operand b2 operand b1 >> = b2 number b2 number (case 3) 
| b2 >> b1 number b1 number (case 3) 


operand b1 (operand b2 operand) b2>>b1 number b1 number (case 3) 


b1 >>=b2 number b1 number (case 3) 


ul operand bi operand | ul >> b1 number b1 number (case 3) 
: b1 >> u1 ul number (case 2) 


operand b1 ul operand ul >> b1 number b1 number (case 3) 
b1 >> ul ERROR (See case 8) 


| operand b1 (u1 operand) ul >> b1 number b1 number (case 3) 
b1 >> ul number b1 number (case 3) 


ul u2 operand u2 >> ul ul number (case 2) 
ul >> = u2 ERROR (See case 10) 


ul (u2 operand) u2 >> ul ul number (case 2) 
ul >> =u2 ul number (case 2) 


Case 3: EVALUATE operand binary-operator operand 
The binary operator is applied to its two operands to produce a numeric result. 
Examples: 


*EVA 10 + 20 
11110Y 36Q 30T 1EH ° 


*EVA .AA>10 
1499919911419911Y 0177777Q =65535T FFFFH °’ 
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*EVA .AA ORIP 
11000000000000Y 30000Q 12288T 3000H ‘0’ 


*EVA 0100:0010H + .AA 
0100:2010H 03010H 


Table 5-8. Conditions and Notation for Examples 


All memory locations are accessible (none are GUARDED). 
SUFFIX = T (implicit radix is decimal). 

IP = 1000H 

DEFINE .AA = 2000H 

DEFINE .BB = FFFFH 

BYTE 1000H = 3EH 

BYTE 2000H = 23H 


has higher precedence than. 
has higher or equal precedence. 
unary operators 

binary operators 


Case 4: EVALUATE operand b1 operand b2 operand 


The binary operator with the highest precedence is evaluated first. If they have equal 
precedence, b1 (the leftmost) 1s evaluated first. 


A. b1>>=b2 
Examples: 


*EVA10+.AA—IP 
1000000001010Y 10012Q 4106T 100AH ° 


“EVA 10* .AA — IP 
11000000000000Y 30000Q 12288T 3000H ‘0’ 


*“EVAIP=.AAOR .BB 
4499991191119911Y 177777Q 65535T FFFFH ° 


*EVA1+2-3 
0Y 0Q OT OH ° 


*“EVA3*2+1 
WY 7Q 71 7H “ 


B. b2>>b1 
Examples: 


*“EVA2+3%*4 
1110¥ 16Q 14T EH °’ 


*“EVA .BB OR .AA AND IP 
14191911111111111Y 177777Q 65535T FFFFH °’ 


*EVA10OR2AND3 
WY 3Q 3T 3H ° 
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Case 4 also fits expressions of any length that use only omay eperatory: Here i isan 
example showing the steps in the evaluation. | | 


Step Operation — | Result 
0 Expression .BB OR IP = .AA AND AFAFH XOR .AA MOD 277 
1 Lookup FFFFH OR 1000H = 2000H AND AFAFH XOR 2000H MOD 277 
2 MOD FFFFH OR 1000H = 2000H AND AFAFH XOR 9FH 
3 = FFFFH ORO AND AFAFH XOR 9FH 
4 AND | FFFFH OR 0 XOR 9FH 
5 OR | FFFFH XOR 9FH 
6 XOR FF60H 


More examples: 


*EVA 2 XOR 3 MASK 41 MOD 33 
102Q 2T 2H ” 


*“EVA2*34+5/3/+7 
1101Y 15Q 13T DH ° 


*EVA2+3*5+/7 
11000Y 30Q 24T 18H °’ 


Case 5: EVALUATE operand b1 (operand b2 operand) 


Binary operator b2 is evaluated first, even if it has lower precedence than bl. Use 
parentheses when b2 must be evaluated before b1. 


Examples: 


*EVA 2* (3 + 5) 
10000Y 2Q 16T 10H °’ 


*EVA .BB / (.AA MASK AFAFH) 
WY 7Q 7T 7H * 


This case can be generalized to include. any number of binary operators and any 
arrangement of parentheses. For example: 


Step Operation | Result 

0 Expression 10 * (44 + (17* 15-6) / 7) 

1 2nd* 10 * (44 + (255 — 6) / 7) 
2 = 10 * (44 + (249) / 7) 

3 Clear (1) 10 * (44 + 249 / 7) 

4 / 10 * (44 + 35) 

5 + 10 * (79) 

6 Clear () 10* 79 

7 1st* 790 


Case 6: EVALUATE ul operand b1 operand 


Precedence decides which operator is evaluated first. 
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A. ul>>b!1 
Examples: 


*EVA -10 + 22 
1100Y 14Q 12T CH ”’ 


*EVA BYTE .AAOR .BB 
14499999999991991Y 177777Q) =65535T =FFFFH ’”’ 


*EVA NOT .BB AND AFAFH 


0Y 0Q OT OH ” 
B. bi>>u1 
Examples: 


*EVA BYTE .AA — 1000H 
111110Y 76Q 62T 3EH ” 


*EVA NOT .BB/23 
1111010011011710Y 172336Q 62686T F4DEH ‘Tt’ 


Case 7: EVALUATE operand b1 ul operand 

The unary operator must have higher precedence than the binary operator. 
A. ul>>bt1 is valid. 

Examples: 


*EVA 10 * -2 
14991141111101100Y 177754Q 65516T FFECH ‘L’ 


*EVA .AA AND NOT .BB 
0Y 0Q OT OH ”’ 


B. bt>>u1 


This produces an error. The operator bl must be evaluated next, and requires two 
numeric operands, but ul operand has not yet been evaluated to a numeric result. 


Examples: 


*EVA10+ BYTE .AA 
ERR 80:SYNTAX ERROR 


*EVA .AA MASK NOT .BB 
ERR 80:SYNTAX ERROR 


Case 8: EVALUATE operand b1 (ul operand) 


Unary operator ul is evaluated first, even if it has lower precedence than binary 
operator bl. Parentheses must be used when ul has lower precedence than bl. 


Examples: 


*EVA10+ (BYTE .AA) 
101101Y 55Q 4571 2DH ‘-’ 
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*EVA .AA MAKE (NOT .BB) 
0Y 0Q OT OH ” 


Case 9: EVALUATE ul u2 operand 


Unary operator u2 must have higher precedence than ul to evaluate without an 
error. | | 


A. ul>>uT1 is valid. 
‘Examples: 


*EVA BYTE — EFFFH 
10000000Y 200Q 128T 80H ” 


*EVA NOT BYTE .AA 
11111111110111100Y 177734Q 65500T FFDCH ”’ 


B. ut>>=u2 
Examples of this case shown below result in an error. 
Examples: 


*EVA BYTE NOT .AA 
ERR 80:SYNTAX ERROR 


*EVA - BYTE .AA 
ERR 80:SYNTAX ERROR 


*EVA BYTE BYTE 1000H 
ERR 80:SYNTAX ERROR 


*EVA--5 
ERR 80:SYNTAX ERROR 


Case 10: EVALUATE ul (u2 operand) 


Unary operator u2 is evaluated first, even if it has lower precedence than ul. Paren- 
theses must be used when wu2 has lower precedence than ul. 


Examples: 


*EVA BYTE (NOT .AA) 
—111101Y = 75Q 61T 3DH ‘=’ 


*EVA — (BYTE .AA) | | 
11111111110111101Y 177735Q 65501T FFDDH ‘]’ 


*EVA BYTE (BYTE 1000H) 
11111110Y 376Q 254T FEH '‘t’ 


*EVA — (— 5) 
101Y SQ ST SH ” 


Two other ‘‘cases’’ can be diagrammed as: 


operand b1 b2 operand 
operand ul b2 operand 
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Both forms produce an error no matter which operator has higher precedence, and 
no arrangement of parentheses can resolve the error. 


These examples show the basic ways to control evaluation with and without paren- 
theses. Parentheses must be used when two operators are concatenated and the sec- 
ond operator has lower precedence than the first. 


Command Contexts 


All expressions produce numeric values as results. The interpretation or use of the 
result depends upon the command that contains the expression. The term numeric- 
expression means an expression in a numeric command context. Numeric command 
contexts treat the result as a numeric value; all bits are significant. 


The term boolean-expression means an expression in a boolean command con- 
text. Only integer values may be used in boolean contexts. Boolean command con- 
texts test only the least-significant bit (LSB) of the result, to obtain a TRUE or 
FALSE value. The result of a boolean expression is TRUE if its LSB is 1, FALSE if 
its LSB is 0. Thus, any number can have a boolean interpretation. 


The BOOL command can be used instead of the EVALUATE command to display 
the evaluation of an expression as TRUE or FALSE. 


A boolean expression uses relational and logical operators to manipulate 
TRUE/FALSE values. When a relational operator is evaluated, the result is always 
either 0 (FALSE) or FFFFH (TRUE). These results can have a numeric interpreta- 
tion, but relational operators have limited usefulness in numeric contexts. 


When logical operators are applied to TRUE/FALSE values, the results are also 
boolean. Specifically: 


NOT: NOT FALSE ~ TRUE 
NOT TRUE > FALSE 


AND: TRUE AND TRUE > TRUE 
TRUE AND FALSE > FALSE 
FALSE AND TRUE > FALSE 
FALSE AND FALSE > FALSE 


OR: TRUE OR TRUE > TRUE 
TRUE OR FALSE > TRUE 
FALSE OR TRUE > TRUE 
FALSE OR FALSE > FALSE 


XOR: TRUE XOR TRUE > FALSE 
TRUE XOR FALSE > TRUE 
FALSE XOR TRUE > TRUE 
FALSE XOR FALSE > FALSE 


In addition to numeric and boolean contexts, there are several other contexts that 
control the interpretation or use of a number or expression. These contexts are sum- 
marized in table 5-9 for reference. 


Expressions 
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$22 


Numeric expression 


Boolean expression 


Address 


Decimal number 


/ Set and change 


commands, etc. 


BOOL, IF, 
UNTIL, 
WHILE 


FROM, 
} content- 
operator, parti- 
tion, SAVE 


statement- 


PRINT 


- | Table 5-9. Com 


16-bit unsigned 


number: bit size 
may be reduced to 


| fit destination. 


LSB =0—> FALSE 
| LSB=1—> TRUE 


Pointer to 


- memory or 


16-bit (or fewer) 


address in 


memory orl/O. 


| positive number 
-number, MOVE, 


mand Contexts 


Limitations 


All operands and operators 
allowed. Numeric constant 


Examples of Use 


IP = .AA*256T + 10FFFH 


without suffix is interpreted 


in current default radix. 


All operands and operators 


.AA AND .BB AND NOT .CC 


allowed. Numeric constants }. 


without suffix are interpreted 
in current default radix. 


Only arithmetic operators are 


- allowed outside of the outer- 


GO FROM .BB + 10 


most parentheses. Constant | 


without suffix are interpreted 


in the current default radix. 


No operators are allowed 


outside the outermost paren- 


theses. All constants without | 


suffix are decimal. 
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CHAPTER 6 
<MULATION AND TRACE 
CONTROL COMMANDS 


Chapter 6 contains discussions, examples, and syntax summaries for each of the 
ICE-86A emulation and trace control commands. 


The following brief outline of Chapter 6 shows how the emulation and trace control 
commands have been classified. 


Emulation Control Commands 


Set Breakpoint Register Command 

Set Tracepoint Register Command 
GO Command 

GR Command 

STEP Command 

Display Emulation Register Command 
Set CLOCK Command | 
Display CLOCK 

Set RWTIMEOUT Command 

Display RWTIMEOUT Command 
ENABLE/DISABLE RDY Command 


Trace Control Commands 
Set TRACE Display Command 
ENABLE/DISABLE TRACE Command 
Display TRACE 
MOVE, OLDEST, and NEWEST Commands 
PRINT Command 


Emulation Control Commands 


The ICE-86A emulator contains an 8086 as the emulation processor. During emula- 
tion, this processor executes the instructions in the user program that have been 
mapped and loaded into the ICE-86A system. The operations of the user system can 
be monitored through the 8086 processor signals. The commands in this section 
allow you to specify the starting address where emulation is to begin, and to specify 
and display the software or hardware conditions for halting emulation and returning 
control to the console for further commands. 
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The commands in this section are as follows: 


COMMAND 
Set Breakpoint-Register 


Set Tracepoint-Register | 


GO command 


GR command 


STEP command 


Display Emulation Register 


Set CLOCK 
Display CLOCK 
Set RWTIMEOUT 


Display RWTIMEOUT 


ENABLE/ DISABLE RDY 


Discussion 


The emulation control commands tell the ICE-86A emulator where to start emula- 
tion and when to halt emulation. 


To initialize for emulation, you map the locations in prototype and ICE-supplied 
memory that are to be accessible to the ICE-86A emulator, and load your program 
code into mapped locations. After the code has been loaded, the ICE-86A emulator 


PURPOSE | 
Set match condition for halting emulation. 


Set match condition for starting or halting trace data 
collection. 


Begin real-time emulation. 


Enable ‘or set and enable breakpoint registers to 
halt emulation. 


Execute single-step emulation. 


Display GO-register, breakpoint and tracepoint 
register settings. 


Designate system clock. 
Display clock setting. 


Enable or disable halting of emulation and error 
message on memory access timeout. 


Display current setting of memory access timeout. 


Enable or disable user-ready signal for memory 
access. 


initializes for emulation as follows: 


Now you can begin emulation by entering the command GO, followed by a carriage 


The instruction pointer (IP) and code segment register (CS) are loaded with the 


address of the first executable instruction in your program. 


The GO-register (GR) is set to FOREVER. The setting of GR identifies the 
combination of factors that are enabled to halt emulation. The setting 


FOREVER means no factors are enabled. 


Both breakpoint registers (BRO and BR1) are set to don’t care and initially 


disabled. 


return. At the command GO, the following occurs: 


Emulation begins with the instruction at the address that is in the IP and CS; 


this is the first executable instruction in your program. 


External signal EMUL is set high (1) to tell an external device that emulation is 


occurring. 


The message EMULATION BEGUN is ieee at the console. 


Emulation continues until you press the ESC key, or until a fatal error occurs. 


(See Appendix B for error messages.) 


Now, if you press the ESC key, the following happens: 


The ICE-86A emulator completes executing the current instruction. 
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e Emulation halts; the IP and CS contain the address of the next instruction to be 
executed. 


e The message EMULATION TERMINATED, CS:IP=bbbb:ddddH is 
displayed. The value displayed is the address of the next instruction to be 
executed. 


e The message PROCESSING ABORTED is displayed, acknowledging the user 
abort (ESC key). 


This is the simplest case of starting and stopping emulation. When the GO-register is 
set to FOREVER, you can enter the command GO to start emulation at the current 
CS:IP address, and press the ESC key to halt emulation. 


Instead of starting wherever the CS:IP happens to be, you may specify the address 
you want for each GO command. There are two ways to do this. First, you can set 
the CS:IP directly to any desired address with commands of the form CS = expr, IP 
= expr, then enter the GO command to start emulation at that address. Second, you 
can specify the starting address as part of the GO command; this form of the GO 
command is as follows: 


GO [FROM address | 
The meta-term address means the following type of entry: 


numeric-expression A numeric expression is evaluated to give the address 
(see Chapter 5). (Table 5-9 specifies restrictions.) 


For example, to start emulation with the instruction at memory location 3000H, you 
could enter: 


CS =0 

IP = 3000H 

GO 
Or, you can enter: 

GO FROM 3000H 
The effect is the same either way. 
The following form of the GO command 1s also valid: 

GO [FROM address | FOREVER 
This form of the GO command enables you to optionally. select the starting address 
and to disable the factors that halt emulation. For example, to start emulation with 
the instruction at memory location 3000H and to set the GO-register to FOREVER, 
you can enter: 


' GO FROM 3000H FOREVER 


The effect of this command is to start emulation with the instruction at location 
3000H. Emulation will stop only when you abort processing. 


The ICE-86A emulator has two breakpoint registers, BRO and BRI. Each of these 
registers can be set to hold a ‘‘match condition’’ that can be used to halt real-time 
emulation when the register is enabled. A second form of the GO command can be 
used to both load and enable breakpoint registers. This form of the GO command is: 
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GO [FROM address | [TILL match-condition [ oe } match-condition }] 


AND: 


This command loads the match-conditions into the breakpoint registers and enables 
the registers to halt emulation on the desired set of system conditions contained in 


these match-conditions. Match conditions are of two types: 


.... . {execution-match-condition 3 
match-conaition = 


non-execution-match-condition 


The breakpoint registers may be set to contain either type of match-condition. 


Execution Match Condition 


An execution-match-condition consists of a single, 20-bit field plus the keyword 
EXECUTED, where each address bit can take any one of three values: 0, 1, or 
‘‘don’t care.’’ An execution match condition 1s examined when the 8086 CPU exe- 
cutes an instruction byte, that is, when the byte is fetched from the 8086 instruction 
queue. The condition ‘‘matches’’ when the executed instruction byte was obtained 
from a memory location whose 20-bit address matches the contents of the selected 
breakpoint register. 


execution-match-condition = eines EXECUTED 
| | ~ (marked-const EXECUTED 


Entering an address causes all 20 bits of the match condition to be loaded with 
O-and 1-bit values. The address contains a base and displacement (e.g., .X or 
50:3000H); note that a single constant is evaluated module 65536 (e.g., 12345H is 
the same as 2345H—use 1234:5H to get all 20 bits). Entering a masked-constant 
causes the 20-bit field to contain 0, 1, or ‘‘don’t care’’ values. The ‘‘don’t care’’ 
values are ignored. The masked-constant can be 20 bits in length. 


The following examples illustrate the use of this form of the GO command. The 
examples assume that the initial contents of the breakpoint registers are as shown 
below: 


BRO = XXXXXH (all bits set to ‘‘don’t care’’) 
BR1 = XXXXXH (all bits set to ‘‘don’t care’’) 


Also, in these examples, the address of .START is 0000:0002H, .DELAY is at 
0000:00DEH, and .DISPLAY is at 0000:0098H. The examples will list a GO com- 
mand followed by the contents of the breakpoint registers as set by the command. 


1. Gofrom .START until the first instruction byte in .DELAY is executed. 
GO FROM .START TILL .DELAY EXECUTED 


‘BRO = 000DEH E (OQOODEH is the 20-bit address of .DELAY, the last E = OPecules 
‘‘EXECUTED’’) 


BR1 = XXXXXH (BR1 is unchanged) 


This command loads BRO with the given match condition: ‘‘. DELAY 
EXECUTED’’). 


2. Gofrom START until address 0200H is executed. 


GO FROM .START TILL 0200H EXEC 
BRO=00200HE 
BR1 = XXXXXH 


This command loads the numeric address and “executed” status into BRO and 
-leaves:BR1 unchanged. 7 
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3. Gofrom .START until address 100:0200H is executed. 
GO FROM .START TILL 100:0200H EXEC 
BRO = 01200H E 
BR1 = XXXXXH 


The pointer address 100:0200H and ‘‘executed”’ status are loaded into BRO, and 
BR1 is unchanged. 


4. Go from .START until an address in an address range specified by a masked 
constant is executed. 


GO FROM .START TILL 10XXH EXECUTED 
BRO = 010XXH E 
BR1 = XXXXXH 


The masked constant address loaded into BRO specifies a range of addresses: 
01000H through O01OFFH. BRO remains unchanged. 


5. Load two execution match conditions, one in each breakpoint register, and 
‘OR’ the conditions. 


GO FROM .START TILL .DELAY EXEC OR .DISPLAY EXEC 
BRO = 000DEH E (Halt when .DELAY is executed.) 
BR1 = 00098H E (Halt when .DISPLAY is executed.) 


This command sets emulation to halt when either the instruction located at loca- 
tion OOODEH (.DELAY) or location 00098H (. DISPLAY) is executed. 


6. Load two execution match conditions and ‘AND’ them. 
GO FROM .START TILL .DELAY EXEC AND .DISPLAY EXEC 
BRO = 000DEH E (Halt when .DELAY is executed.) 
BR1 = 00098H E (Halt when .DISPLAY is executed.) 
ERR AE:INVALID ‘‘AND’’ IN GO-REG(Error message generated by this command) 


This command sets emulation to halt when the instruction located at location 
OOODEH (.DELAY) ‘AND?’ the instruction located at location 00098H (.DISPLAY) 
are executed. Execution of two separate instructions cannot occur at the same time. 
Therefore an error message is generated by this command, and the command is not 
executed. 


Non-Execution Match Condition 


The non-execution-match-condition must contain one or more of four types of 
fields: a set of addresses, a list of bus status types, a set of data values, and a seg- 
ment register designation. A non-execution-match-condition matches whenever a 
breakpoint that contains a set of one or more of the above fields matches corre- 
sponding state values in the user system during real-time or single-step emulation. 


address-match-range 
match-status-list 
data-match-range 
segment-register-usage 


non-execution-match-condition = 


Address-match-range, match-status-list, data-match-range, and segment-register- 
usage must be used in the order shown. At least one of these fields must be entered in 
a given command to establish a non-execution match condition. 
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_Address Match Range 


An address-match-range may consist of a single address or masked constant, an 
“‘unlimited’’ range of addresses, or a set of match partitions. If an ‘‘unlimited’’ 
range of addresses are to be entered, an address value modified by the mnemonic UP 
or DOWN is entered. UP implies any address value equal to or greater than the 
stated address. DOWN implies any address value equal to or less than the stated 
address. The match partition may be any of three types: partitions, memory 
references, and/or typed memory references. If the address-match-range contains 
more than one partition, all partitions must have the same base and their 
displacements must lie within a 1K-byte range that begins at an even address. If there 
is only a single partition, it must lie within a 1K-byte range to be contained in a single 
breakpoint register. If the partition does not lie within a 1K range, two registers are 
required to hold the partition. Therefore an address-match-range can be defined as: 


address :: masked-const 


address UP ::address DOWN 


addres-match-range = partition 
OBJECT memory-reference ses 
OBJECT typed-memory-reference 


All references to a ‘‘1K-byte range’’ should begin at an even address. For example, 
‘BRO =1000:20 LEN 1K’ is valid, but ‘BRO=1000:21 LEN 1K’ is not valid. 


By expanding the definition of partitions and memory reference to their component 
parts, the definition of address-match range becomes: 


address :: masked-const 


address UP :: address DOWN 


address TO address 
address LENGTH address 
OBJECT BYTE address © 
OBJECT WORD address 
OBJECT SINTEGER address ; 
OBJECT INTEGER address 
OBJECT POINTER address 
OBJECT REAL address 
OBJECT DREAL address 
OBJECT TREAL address 
OBJECT typed-memory-ref 


address-match-range = 


For example, an address-match-range of a single address would be 3000H, whereas 
using the masked constant 30XXH would result in a match range of 3000H through 
30FFH. Two examples of the use of partitions in a match range are: 

4000 TO 4100 
and 


4000 LENGTH 101 


Both of these partition specifications result in the range of addresses, 4000 through 
4100. | 


A sequence of discontinuous addresses can be specified by: 


OBJECT BYTE 4000, OBJECT WORD 3188, OBJECT !!MOD1 ISYMSAM, ... 
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This would result in a string of discontinuous match addresses, the third address in 
the above string being specified by a typed memory reference. OBJECT indicates a 
partition beginning at the low address of the memory object and whose length is the 
length of the object. In the above example, ‘OBJECT BYTE 4000’ specifies a one- 
byte partition whose address is 4000. ‘OBJECT WORD 3188’ specifies a two-byte 
partition starting at 3188 and ending at 3189. ‘OBJECT .. MODI .SYMSAM”’ 
specifies a partition starting at the address given in the symbol table for !!MOD1 
!'SYMSAM and whose length is specified by the memory type of symbol .SYMSAM. 
For example if SSYMSAM is type WORD, the partition will be two bytes in length. 


OBJECT REAL 4000, OBJECT DREAL 5000, OBJECT TREAL 6000 


In the above example, ‘OBJECT REAL 4000’ specifies a four-byte partition at 
address 4000. ‘OBJECT DREAL 5000’ specifies an eight-byte partition at address 
5000, and ‘OBJECT TREAL 6000’ specifies a ten-byte partition at address 6000. 


Match Status List 


The match-status-list field matches whenever the 8086 bus status is any of those 
listed in the match status list: 


READ match on memory read other than an instruction fetch. 
WRITTEN match on memory write. 

INPUT match on an1/O read. 

OUTPUT match on an1/O write. 

FETCHED match onamemory read into the execution queue. 
HALT , match on 8086 halt. 

ACKNOWLEDGE match on 8086 interrupt acknowledge. 


A match-status-list may consist of one or more of the above bus status types and 
they may be listed in any order: 


READ 

WRITTEN 

INPUT 
match-status-list= | OUTPUT saa 

‘FETCHED 

HALT 

ACKNOWLEDGE 


An example of a match-status-list would be: 


FETCHED, READ, HALT, WRITTEN, ACKNOWLEDGE 


Data Match Range 


The data-match-range field can be used to specify data values. The syntax is similar 
to address-match-range, except the OBJECT form is not allowed. In this case, the 
values specified by address will be treated as data values and used to match against 
values on the 8086 address/data lines at data time. 


address :: masked-const 
data-match-range = VALUE address UP :: address DOWN 
partition, ... | 
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Data values must be integers. All data references in the 8086 are on even byte boun- 


daries; therefore data match conditions must be used with caution. 


e <A 16-bit data value matches if that value i is accessed on an even- byte boundary 
(i.e., low-order byte of data at an even address). 


e An 8-bit data value must be specified as either an even byte (by giving 8 “don’t 


care’’ bits in the high-order byte) or an odd byte (by giving 8 “‘don’t care’’ bits 
in the low-order byte). 


Segment Register Usage 


The segment-register-usage field is used to specify one of the four segment registers. 
A match occurs whenever the segment register used in an effective address calcula- 
tion 1s the one specified in the segment-register-usage field. Segment register usage 
occurs at data time. 


USING SS 
USING CS 
| USING DS 
| USING ES 


segment-register-usage = 


Match Condition Restrictions 


Figure 6-1 illustrates a detailed specification of the non-execution-match-condition. 
The following examples illustrate a set of restrictions that must be observed in the 
use of match conditions in emulation commands. 


Data values, bus status, and segment register usage come out of the 8086 at data- 


time. Address values and bus status are available at address-t time. The following 


restrictions apply to match conditions: 


e Breakpoint register BRO cannot Conia data-time values at the same time 
breakpoint register BRI contains address-time values if the two registers are 
ANDed (the reverse is permissible). 


e Neither BRO nor BRI may contain an execution-match-condition if es are to 


ANDed. 


A warning message Is issued after a Set BR command or a Set GR command if the 
command results in either of the above conditions. An Error is issued on a GO com- 
mand if the command results in either of the above conditions. 


e If amatch-condition specifies both address and data or segment register usage, 
the match condition requires both breakpoint registers; hence this match- 
condition cannot OR/AND with another match-condition. 


All partitions in a multi-partition match condition must have the same base value. 
For example, the following command generates the error message shown: 


~ GO FROM .START TILL 0:0000 LEN 1, 100:1000H 2 READ 
ERR AD:DIFFERING BASIS (error message) | 


All the displacement values must be within a 1K- byte range (beginning on an even 
address) to be contained in a single breakpoint register. Displacements may exceed 
1K only if there is a singie partition. 


The following match condition cannot be contained i in one e breakpoint register: 


GO oe START TILL 0:0000 LENGTH 2048T WRITTEN, 
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The above command would require both breakpoint registers as the partition 1s 2K- 
bytes in length. 


The following command would generate an error as two partitions are specified and 
the displacements exceed IK. 


GO FROM .START TILL O, 2048T WRITTEN 


The following command would generate an error as the partition requires both 
breakpoint registers. Therefore the partition ‘.BEGIN’ cannot be entered. 


GO FROM .START TILL 0 LEN 2048T, .BEGIN W 


Segment register usage can only be used in conjunction with a single match value as 
illustrated in the example below. 


GO FROM .DELAY TILL .MAINTIME READ USING DS 


The last form of the GO command is in the following format: 


GO |FROM address |[TILL break-reg | fies break-reg ] 
where break-reg references breakpoint register BRO, BRI, or BR. This command 
form is used when the breakpoint registers have been set prior to the entering of this 
command. The command enables the referenced breakpoint register but does not set 


‘its contents. The Set Breakpoint command, GR command, or a previous GO com- 


mand must be used to set the required breakpoint registers. Care is required in 
ANDing two breakpoint registers in this command. Only two non-execution-match- 
conditions can be ‘‘ANDed’’. An error results if either of the conditions described 
below occur. | 


e BRO contains data values or segment register usage, and BRI contains address 
values. 


e Either of the breakpoint registers contains an execution-match-condition. 


NOTES 


During the first cycle of emulation, the ICE-86A emulator fetches 
the word at absolute memory location eight. The word is 
immediately flushed from the queue; it is never executed. The ICE 
emulator user should be aware that these memory operations are 
part of the normal operation of the emulator and that they do not 
impact successful application of the ICE-86A emulator. 


The user may experience excessive response times for external bus 
requests while setting breakpoints. The ICE-86A firmware loads 
the breakpoint registers; there are 4096 steps involved in loading 

_ these registers. Each step takes up to 500 microseconds to com- 
plete. In between each step there are periods of inactivity (break- 
points not being loaded) of approximately equal length, about 
several hundred microseconds in duration. While each of the 
breakpoint-loading steps is being executed, the Request/Grant 
response capabilities of the ICE-86A emulator are temporarily 
disabled. (During the inactive periods, the response capabilities are 
enabled.) Hence, external bus requests may not be answered as 
quickly as under normal circumstances. — 


Breakpoint Restrictions | 


There are two cases in which an interrupt request is not recognized until after the 
following instruction. A MOV (move) to segment register instruction or a POP seg- 
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address :: masked-const 


address UP :: address DOWN 


VALUE address :: VALUE masked-const 


AD 
address TO address Neue i USING SS 
, | VALUE address UP 
address LENGTH address aes eae VALUE address DOWN aie ne 
ACKNOWLEDGE | ere 
K L VALUE | address TO address 
ARIEL WOR pithnecads bo LENGTH address ; 
| OBJECT SINTEGER address 
OBJECT INTEGER address 
OBJECT POINTER address 
OBJECT typed-mem-ref 
(match- (segment- 
<—(edaress-match-range) ——— status- ———_—__~>> Se (data euneeeade ———_ > |<—_ register- —> 
list) usage) 
Note: (address-match-range), (match-status-list), (data-match-range), and (segment- 
register-usage) must be used in the order shown. At least one of these fields must be 
entered in a given command and no field may be repeated in the command. : 
Figure 6-1. Non-Execution Match Condition 162554-7 


SpueUIWOZD [O.NUOD so¥1] pue uONeNu 


V98-AOI 


ICE-86A Emulation and Trace Control Commands 


ment instruction will cause interrupt recognition to be inhibited until the following 
instruction has been executed. This mechanism protects a program that is changing 
to a new stack (by updating SS and SP). If an interrupt were recognized after SS had 
been changed, but before SP had been altered, the processor would push the flags, 
CS and IP, into the wrong area of memory. It should be noted that whenever a seg- 
ment register and another value must be updated together, the segment register 
should be changed first, followed immediately by the instruction that changes the 
other value. 


If your code contained the following sequence of instructions: 


MOV DS,DATASEG 

MOV ES,EXTRASEG 
MOV SS,STACKSEG 
MOV SP,STACKPOINTER 
JMP START 


No interrupts will be recognized until the MOV SP instruction has completed. 
Similarly, if your code contained the following sequence of instructions: 


POP DS,DATASEG 

POP ES,EXTRASEG 

POP SS,STACKSEG 

POP SP,STACKPOINTER 
JMP START 


No interrupts will be recognized until the POP SP instruction has completed. Nor- 
mally the single step mode will generate a type | interrupt after each instruction. A 
breakpoint is recognized by a type 3 interrupt. The MOV and POP instructions 
described above will cause these interrupts to be inhibited until the instruction 
following the MOV or POP has been executed. 


Since the ICE-86A emulator uses the NMI to effect breakpoints for SINGLE/STEP 
and GO emulation, the break will be inhibited as long as the interrupt protection 
feature is in effect, 1.e., an attempt to break at the MOV ES,EXTRASEG instruc- 
tion will actually break when the MOV SP instruction has completed, resulting in 
the IP pointing to the JMP START instruction. 


A third case in which program execution does not terminate at the specified break- 
point occurs due to 8086 queue operations. Execution breakpoints are complicated 
by the necessity to trace the 8086 queue operations, and thus, there is no guarantee ~ 
that execution will be terminated immediately after the instruction specified. 


If the instruction requires only two clock cycles to execute, then (depending on the 
current queue depth) the emulator may slip past the requested breakpoint by one 
instruction. Due to the complexities of the breakpoints and the exact timing uncer- 
tainties, the ICE module will not detect such a slip. 


The user may determine this type of slip, however, by examining the trace data and 


comparing the next to last instruction in the trace data to the potential break 
conditions. 
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‘Setting The Go- -Register 


To enable either ist both using BR) of the breakpoint registers asa halt coiidition, 
you can use a set GR command of the form: 


— GR =halt-go-condition 
The meta-term halt-go-condition means any of three exclusive types of halt 
conditions: | 
FOREVER 
ae AND 
halt-go-condition= J T\iLL break-reg OR break-reg © 


TILL match-cond Ei pee maton-cond | 


Using the FOREVER condition in the Go-Register command: 


GR = FOREVER 


would disable both breakpoint registers. 


The following command would enable BR1, once BR1 had been set using the Set 
Breakpoint Command. 


GR=TILL BR1 
Both registers can be enabled and ORed with the following command: 
GR = TILL BR1 OR BRO 


Both registers can be set within a limited range and then combined to expand that 
range. 


If BRO were set to 800 UP and BR1 were set to FFEFF DOWN the command: 
GR = BRO AND BR1 
would break between 800 and FFEFF. 


BRO would be loaded with a match condition and enabled with the following 
command: 


GR = TILL 3000H WRITTEN, FETCHED 


~ The following command would load BRO with the first match condition and BRI 


with the second stated match pone 
GR = TILL 3000H WRITTEN, FETCHED OR INPUT VALUE 0123 USING DS 


BRO would contain the match condition 3000H WRITTEN, FETCHED and BRI 
would contain the match condition INPUT VALUE 0123 USING DS and both 


registers would be enabled and ORed. 


The following command would require both breakpoint registers to contain the 


-match condition: 


GR = TILL DELAY FETCHED OR READ VALUE .MAINTIME USING DS 
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BRO would contain the match condition .DELAY FETCHED and BR1 would con- 
tain the match condition READ VALUE .MAINTIME USING DS. 


The following command would require both breakpoint registers to contain match 
conditions that are ‘‘ANDed’’: 


GR = TILL !SIDETIME READ AND VALUE 8 


BRO would contain the condition .SIDETIME READ and BRI1 would contain the 
match condition VALUE 8. These conditions are ANDed. 


Setting Tracepoint Registers 


The ICE-86 emulator has two tracepoint registers, ONTRACE and OFFTRACE. A 


tracepoint register may only contain a non-execution match condition. Also the 
match range may only contain an address, masked constant, or data, and segment 
register usage may not be used with an address condition. For example, the follow- 
ing commands are valid: 


ONT = 3000H WRITTEN, FETCHED 
OFF = INPUT VALUE 0123 USING DS 


However, the commands: 


OFFTRACE = 3000H EXECUTED 
ONTRACE = 3000H READ USING CS 


are invalid as EXECUTED is invalid in a tracepoint, and the segment register CS is 


specified with an address condition. 


Command Signal Timeout 


When the 8086 accesses INTELLEC or DISK mapped memory, a command signal 
timer starts counting. If the access is not completed before it times out, the ICE-86A 
emulator will cause the READ and WRITE command signals to go inactive to the 
user system. The RWTIMEOUT commands are used to set and display the current 
setting of the command signal timer. 


Emulation Timer 


An emulation timer is enabled when emulation is running. The timer can be used to 
determine how long it takes the ICE-86A emulator to emulate a given segment of 
code. The timer is a 2-MHz clock (i.e., counts are intervals of 500 ns), derived from 
the crystal on the Control board. 


The timer starts when the GO command is entered, starting emulation. The timer 
starts counting at the first T3 state of the first instruction emulated. HTIMER stops 
counting where a maximum count of approximately 33 minutes is reached. TIMER 
continues counting modulo 65536. 


The timer is reset to 0 (before starting to count) when the GO command is entered 
with a FROM clause or when CS:IP is changed or when ENABLE/DISABLE 
TRACE. If you want to reset the timer without changing the current program 
counter, enter a command such as GO FROM CS: IP. 
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After emulation halts, you can display the value of the timer in the current output 
radix. The display command TIMER displays the low 16 bits of the timer value; the 
command HTIMER displays the high 16 bits of the timer value. The tokens TIMER 
and HTIMER can also be used as keyword references in commands and expressions. 


With the timer, you can measure the real elapsed time required to emulate a given 
code sequence. The elapsed time can then be compared to the calculated time based 
on the number of clock states in each instruction and the speed of the system clock. 
Note that code mapped to user runs at real-time; the timer value for code mapped to 
prototype memory Is the real-time value. 


A special application of the emulation timer is optimization of coprocessor code. 
When the emulated 8086 CPU is configured, for example, in local mode with an 
8087 NDP (Numeric Data Processor), then the two microchips can execute instruc- 
tions in parallel. In general, the 8087 coprocessor fetches its instructions out of the 
8086 instruction stream and begins to perform a floating point calculation; the 8086 
will continue executing additional code while the 8087 proceeds with this calcula- 
tion. The 8086 will execute a WAIT instruction when it can no longer execute code 
without the result of the 8087 calculation (inserted in code by user or compiler), and 
will continue when the 8087 finishes executing and releases the TEST pin. Optimiza- 
tion, then, consists of reducing the amount of time the 8086 processor spends 
waiting for the 8087 NDP to complete its instructions. By using the emulation timer, 
the operator can determine the amount of time floating point instructions take to 
execute in the 8087 coprocessor, and plan the 8086 code to execute in approximately 
the same length of time. | 
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Set Breakpoint Register Command 


(1) break-reg = address EXECUTED :: masked-const EXECUTED 


(2) break-reg = | address-match-range | |match-status-list] |data-match-range || seg-reg-usage | 


NOTE 


Form (2) requires that the address-match-range, match-status-list, 
data-match-range, and seg-reg-usage fields be used in the order 
shown. At least one field is required in a given command and no 
field may be repeated in the command. Restriction: the fields 
selected must fit in one breakpoint register. 


Examples: 


BRO = 1XXXH EXECUTED 


BR1 = 3000H UP WRITTEN 
BR =3000H TO 30FFH READ USING CS 
BR =3000H LENGTH FEH, OBJECT !VAR WRITTEN 


break-reg 


address 


maskea-const 


EXECUTED 


address-match-range 


match-status-list 


data-match-range 


seg-reg-usage 


The name of one of the breakpoint registers (BRO, BR1) 
or BR to set both registers to the same match condition. 


The assignment operator. 


The address of the memory location or I/O port, or a 


data value. 


A masked constant used to define a range of memory 
locations or data values. 


Denotes that the match condition is the execution (CPU 
fetch of the instruction byte from the instruction queue) 
of the instruction byte whose address is given by address 
or masked-const. 


A set of one or more addresses. (See Address Match 
Range in Chapter 6.) 


A set of bus status conditions to be used as match 
parameters. (See Match Status List in Chapter 6.) 


A set of data values to be used as match parameters. (See 
Data Match Range in Chapter 6.) 


A specification of one of the segment registers to be used 


as a match parameter. (See Segment Register Usage in 
Chapter 6.) 


NOTES 


See Breakpoint Restrictions (Chapter 6) for breakpoint interrupt 


restrictions. 


Execution breakpoints are complicated by the need to trace the 8086 queue 
operations, and thus do not guarantee that execution will be terminated 
immediately after the specified instruction. The ICE emulator may slip past 
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the breakpoint instruction and stop at the next instruction. This slippage is 
dependent on the current depth of the queue when the breakpoint instruc- 
tion requires only two clock cycles for execution. Due to the complexity of 


the breakpoints and exact timing uncertainties, the ICE emulator will not 


detect this slip. The user may determine that the slippage has occurred by 
examining the trace data and comparing the next-to-last instructions exe- 
cuted to the potential break conditions. 
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Set Tracepoint Register Command 


address 
trace-reg = 


masked-const 


(address- 
match ) 
range) 


— | WRITTEN 


-READ 


USING SS} 


pied VALUE address ‘| usiINnccs | 
: FOUTPUT ee | USING DS 

‘FETCHED VALUE masked-const } USING ES| 
| FHALT - | 

ACKNOWLEDGE} 

(match- (data-match-range) (segment- 

status- | register- 

list) usage ) 


NOTE 


The address-match-range, match-status-list, data-match-range, and 
segment-register-usage fields must be used in a command in the order 
shown. At least one field is required in a given command and no field may 
be repeated in the command. A segment-register-usage field or data-match- 
range may not be used with an address condition (address-match-range 
field); you cannot mix address-time fields with data-time fields. 


Examples: 


ONTRACE = 2340 READ, ACKNOWLEDGE 
OFFTRACE = INPUT, OUTPUT VALUE 1234H 
ONTRACE = !X FETCHED 

ONTRACE = R,W VALUE 40XX USING ES 


OFFTRACE = USING ES 


trace-reg 


& 


address 
masked-const 


match-status-list 
data-match-range 


segment-register-usage 


The name of one of the tracepoint registers, ONTRACE 
or OFFTRACE. 


The assignment operator. 


The address of the memory location or I/O port, or a 
data value (see Data Match Range). 


A masked constant used to define a range of memory 
locations or data values. 


See Match Status List. (Chapter 6.) 
See Data-Match Range. (Chapter 6.) 


See Segment Register Usage. (Chapter 6.) 
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GO Command 
FROM aaaress 
FOREVER | AND 
GO | TILL break-reg [ { OR } break-reg ] 
TILL match-cond [ { AND \ match-cond ] | 
| OR | 
Examples: 
GO 
GO FROM 3000H 


GO FROM .START TILL BRO 

GO FROM 3000H TILL 3000H EXECUTED 

GO TILL INPUT VALUE 1000 

GO FROM 1000H TILL 3000H TO 30FFH READ USING DS 
GO FROM 3000H TILL OBJECT POINTER .START READ 


GO Command keyword that starts emulation, subject to the 
current start and halt conditions. 

FROM Keyword introducing a starting address. 

address The address of the memory location of the first 
instruction to emulate, 1.e., the start address. 

FOREVER Disables all breakpoint conditions; emulation can be 
stopped only by user aborting processing. 

TILL A keyword introducing one or more match or halt 

| conditions. _— 

break-reg One of the breakpoint registers (BRO, BR1), or BR to set 
both registers to the same match setting. 

match-cond One of the following forms of breakpoint register 


settings. 


1. execution-match-condition. (See Execution Match 
Condition in Chapter 6.) 


2. non-execution-match-condition. (See Non-Execution | 


_ Match Condition in Chapter 6.) 


NOTES 


The ICE-86A emulator cannot enter GO or STEP with the 8086 Trap Flag 
(TFL) set. Therefore a warning message will be issued whenever GO or 


STEP commands are executed with TFL =1 , and TFL will be set to 0. The 


Trap Flag is ignored during single step mode and on the first instruction 
step during emulation. 


‘ 


If either breakpoint register contains a match range other than a single 


match-value and the breakpoint register has changed since the last GO com- 
mand, the message “‘LOADING RANGE BREAKPOINTS” Is issued, and 
it takes approximately 10 seconds to load breakpoints and hardware before 
emulation begins. | 


See Breakpoint Restrictions (Chapter 6) for breakpoint interrupt 
restrictions. : | 
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Execution breakpoints are comphiccated by the need to trace the 8086 queue 


operations, and thus do not guarantee that execution will be terminated 


immediately after the specified instruction. The ICE emulator may slip past 
the breakpoint instruction and stop at the next instruction. This slippage is 
dependent on the current depth of the queue when the breakpoint instruc- 
tion requires only two clock cycles for execution. Due to the complexity of 
the breakpoints and exact timing uncertanties, the ICE emulator will not 
detect this slip. The user may determine that the slippage has occurred by 
examining the trace data and comparing the next-to-last instructions exe- 
cuted to the potential break conditions. 


Upon normal termination of code execution containing string operations, 
the ICE-86A emulator appears to hang (no prompt) immediately after 
display of CS:IP. It may take up to 40 seconds for the prompt to appear. 
No such hanging occurs when trace collection is disabled. The cause of this 
hanging is connected to the repetitive nature of string operations and the 
size of the trace buffer. The maximum 1021 allowed frames of trace 
information in the trace buffer can easily be surpassed when collecting trace 
information during execution of string instructions. The original opcode 
fetch of the string instruction is beyond the 1021 frames of trace informa- 
tion. Trace collection and CPU operation are out of sync. The trace buffer 
may be full, but there is no trace. This is the normal trace operation for 
string operations. 
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Set GO-Register (GR) Command | 


FOREVER 


{ { AND: 
TILL break-reg [{ OR } break-reg | 


D: . 
} match-cond | ‘ 


TILL match-cond [{ OR 


Examples: 


GR = FOREVER 

GR=TILL BR1 

GR = TILL BRO OR BR1 

GR = TILL OBJECT !ABLE1 

GR = TILL OBJECT POINTER 0123 READ, WRITTEN VALUE 3000 USING DS 


GR Command keyword referring to the GO-register (halting 
conditions for emulation). 


= The assignment operator. 


FOREVER Disables all breakpoint conditions; emulation can be 
stopped only by user aborting processing. 


TILL A keyword introducing one or more match or halt. 
conditions. : 


break-reg One of the breakpoint registers, BRO or BRI (or BR to 
| denote both breakpoint registers) that is to be enabled. 


match-cond One of the following forms of breakpoint register 
settings: 


1. execution-match-condition. (See Execution Match 
Condition in Chapter 6.) 


2. non-execution-match-condition. (See Non-Execution 
Match Condition in Chapter 6.) 


NOTE 
See Breakpoint Restrictions (Chapter 6) for breakpoint restrictions. 
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STEP Command 
STEP [FROM address] 
Examples: 


STEP 

STEP FROM 1FFFH 

STEP FROM ..MOD .GO 

STEP FROM !PTR 

STEP FROM #123 + 10 

STEP FROM CS:(WORD .X) ;SHORT JUMP INDIRECT THROUGH .X 


STEP A command keyword that causes the ICE-86A emulator 
to execute a single step of emulation. 


FROM A function keyword introducing the address where a 
7 single step of emulation is to be executed. | 


address See address. (See Set Breakpoint Register Command in 
Chapter 6.) 


The STEP command causes the ICE-86A emulator to execute one single step of 
emulation. If FROM address is not included in the command, the emulation step is 
executed from the current address. If FROM address is included in the command, 
the value of the address is loaded into the CS and IP and the step is executed from 
this location. 


NOTES 
The STEP command is very useful in repeat loops and macros, (see Chap- 
ter 8) where terminating condition can be given (UNTIL or WHILE) and 
system status and values can be displayed after each step. However, the user 
is cautioned that a hardware reinitialization occurs intermittently with a 
reset timeout when the RESET pin is pulsed during a repeat of the STEP 
command. 


See Breakpoint Restrictions (Chapter 6) for step mode interrupt 
restrictions. 


Trace data does not display byte reads of absolute memory locations 08H 
through OBH following single step execution. Absolute memory locations 
08H through OBH contain the NMI vector for Interrupt 2. During single- 
step mode, which is the execution of single instructions halted via an Inter- 
rupt 2, the ICE-86A emulator accesses locations 08H and 09H to enter and 
exit emulation. The ICE software masks these reads out to conserve space in 
the trace buffer. The software does not distinguish between ICE emulator 
reads and user reads of these locations. As a result, user code reading these 
locations during the single-step mode is also masked out. The instructions 
are executed but do not appear in the trace data. | 
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Display Emulation Register Command 


GR 

| ABSOLUTE 
break-reg [ BASE [expr] 3 
| ABSOLUTE 
trace-reg [ BASE [expr] ] 

Examples: 

GR 
BRI 
BRO BASE CS 
BRO BASE CS SYMBOLICALLY 
BR BASE 
OFFTRACE 
OFF ABSOLUTE 
ONT BASE DS 


ONTRACE BASE DS SYM 


GR A command keyword that causes the content of the 
GO-register (factors enabled to halt emulation) to be 
displayed. 

break-reg One of the breakpoint register keywords BRO or BRI, to 


obtain a display of the register setting, or the keyword BR 
to cause the display of the settings of both breakpoint 
registers. 


“trace-reg One of the tracepoint register keywords ONTRACE or 


OFFTRACE to command the display of the content of 


the designated register. 


ABSOLUTE Display all addresses as 20-bit numbers (this is the 


default). 
BASE Display all addresses in base and displacement format 


(e.g., 0000:1000H). If no expr is given, display with the 
base that was used to set the register. 


expr An integer value that specifies that all addresses are to be 
displayed as their displacement from (expr )*16. An error 
occurs if an address needs a displacement of less than 0 or 
greater than 65535 from the base (expr ). Typically expr 
will be a segment register name; thus ‘BRO BASE CS’ 
displays the displacements of the addresses in BRO using 


the current code segment register. If no expr is given, use 


the base that the register was set with. 
NOTE 
Data values are always displayed as 16-bit numbers, masked-constants as 


16-bit or 20-bit strings with Xs (in hexadecimal if possible, or else in 
binary). 


Internal to the ICE-86A emulator, match addresses are stored as 20-bit 
numbers. Thus ‘‘GO TILL 20:8 R’”’ breaks whenever 208H is read, even if it 
is read as 10:108H. | 
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Set CLOCK Command 
7 Pu esia 
CLOCK= 1 EXTERNAL 
Examples: 


CLOCK = INTERNAL 
CLOCK = EXTERNAL 


CLOCK This command keyword enables the user to designate the 
type of clock being used in the system: user-provided or 
ICE-provided. 


= The assignment operator. 


INTERNAL Designates that an ICE-provided clock is being selected. 
This is necessary whenever the cable is not plugged into 
user system. When clock is set to Internal, the ICE-86A 
emulator is operated in stand-alone mode. The Socket 
Protector should be mounted on user cable in this mode 
of operation. 


EXTERNAL Designates the clock to be user supplied. This is desirable 
whenever the cable is plugged into a user system, with 
user supplied clock. Not specifying CLD = EXT when a 
user clock is available could cause non-synchronization 
of user hardware with the ICE emulator. 


NOTE 


Further information on use of the CLOCK command is provided in 
Appendix G. 


Display CLOCK Command 
CLOCK 

Examples: 
CLOCK 


CLOCK | A command keyword that causes the display of the clock 
setting. 
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Set f VA 


RWTIMEOUT = 


Examples: 


RWTIMEOUT = INFINITE 


INFINITE 
expr-10 NOERROR | 


;DISABLE RWTIMEOUT 


RWTIMEOUT = 500 ERROR ;SET TIMEOUT TO HALT EMULATION WITH REPORT 


RWTIMEOUT = 500 


;HALT EMULATION WITH ERROR REPORT 


RWTIMEOUT = 1500 NOERROR —_;SET TIMER BUT DO NOT HALT EMULATION WHEN IT 


RWTIMEOUT 


INFINITE 


expr-10 


ERROR 


NOERROR 


‘TIMES OUT 


A command keyword denoting that a command signal 
timeout function is to be set. If not set by the user, the 
RWTIMEOUT is set to its default value of 1000 
microseconds. 


Denotes that the command is a set signal timeout 
command. 

Sets command signal timeout to ‘‘infinite,”’ effectively 
disabling the timeout. 

An integer value that specifies the timeout value in 
microseconds. The integer value must be greater than 0 
and less than 32K, and the default suffix when evaluating 
expr-10 is decimal. The default value is 1000 
(microseconds). 


Specifies that error is to be reported whenever command 
signal times out. This is the default setting. 


Specifies that command signal timeout is not to halt 
emulation. 


NOTES 


Byte, Word, and Port commands respond with DONE timeouts if 
RWTIMEOUT = INFINITE and no user ready occurs for 15 seconds. The 
8086 is still active on the user bus, however, until the RESET HARDWARE 


command is entered. 


Further information on use of the RWTIMEOUT command is provided in 


nprene G. 


RWTIMEOUT 


RYIMEOUT 


Display RWTIMEOUT C 


‘Causes the current setting of the command signal timeout 
tobe displayed. 
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ENABLE/DISABLE RDY Command 


ENABLE } 
DISABLE ve 
ENABLE A command keyword denoting that an ICE-86A element 
is to be enabled. 
DISABLE A command keyword denoting that an ICE-86A element 
is to be disabled. 
RDY A reference keyword specifying the user-ready signal for 


memory access. 


The ICE-86A emulator allows the user to enable and disable the user-ready signal. If 
RDY is enabled, the ready signal to the 8086 is a local ready (generated by the 
ICE-86A emulator) AND user ready; otherwise ready to the 8086 is either the local 
ready when mapped to local memory or user ready when mapped to user memory. 
RDY 1s initially enabled. 


NOTES 
When emulating in the user memory with DISABLE RDY invoked, the user 
ready pin must be active to continue emulation. Since all I/O Ports are in 
the user system, an access to a port requires a user Ready to continue 
emulation. 


Further information on use of the ENABLE/DISABLE RDY command is 
provided in Appendix G. 


Emulation and Trace Control Commands 


6-26 


Trace Control Commands 


The ICE-86A emulator can record program execution through the collection of trace 
data in a trace buffer during real-time and single-step emulation. The commands in 
this section allow you to specify the conditions for enabling and disabling trace Gala 


collection during emulation and to control the display of trace data. 


The commands in this section are as follows: 


- COMMAND PURPOSE 
Set TRACE Display Mode Establishes trace data that will be displayed as 
frames or instructions. 
ENABLE/DISABLE TRACE Enables or disables the collection of trace data. 
Display TRACE Mode Causes the display of the current display mode. 
MOVE, OLDEST, NEWEST Set trace buffer pointer to entry to be displayed. 
PRINT Display one or more entries from the trace buffer. 
Discussion 


The unit of ICE-86A emulation is the instruction. During real-time and single-step 
emulation, the ICE-86A emulator traces program execution twice per 8086 bus 
cycle: first when the address signals are valid and then when the data signals are 
valid. It also traces each CPU clock cycle during which the execution queue is active. 


The ICE-86A emulator contains a trace buffer used to collect trace data (frames) 
during real-time and single-step emulation. The trace buffer holds a total of 1023 
frames or approximately 300 bus cycles of trace information. Each entry in the buf- 
fer 1s a frame, and Is either half a bus cycle or contains queue status, or both. Each 
frame contains: 


bit-size | purpose 


20 Address/data 

Bus status (S0/, $1/, S2/) 

Queue Status (QS0, QS$1) 

Queue depth 

Frame type indicator: address, data, or queue Status 
Start/stop trace marker for conditional trace 

Byte High Enable (BHE/) | 


at amb KO CO RO CO 


Trace is initially unconditionally on and the buffer is initially empty. The buffer is 
cleared whenever the user changes the IP or CS, either by a FROM clause on a GO 
or STEP command or by a Change command. Otherwise new trace data is appended 
to the end of existing trace data and the most recent 1023 frames are retained in the 
buffer. Similarly, the TIMER and HTIMER registers are reset to zero each time the 
user changes the IP or CS register. Also, whenever the user issues an enable/disable 
trace command, the trace buffer is cleared to empty and TIMER and HTIMER are 
reset to zero when the user next enters emulation. 
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The user can control the collection of trace data using the tracepoint registers. The 
enable/disable trace command enables trace conditionally and unconditionally or 
disables trace unconditionally: 


ENABLE TRACE Turns trace on unconditionally during 
subsequent emulations. 

ENABLE TRACE Now ee | Trace will be turned on whenever the 

OFF register matches and turned off whenever 


CONDITIONALLY 
| the OFFTRACE register matches. 


NOW ON indicates that trace is turned on for the beginning of the next emulation; 
NOW OFF indicates it is off; if neither is present the trace is left in its current state. 


DISABLE TRACE Turns trace off unconditionally during 
subsequent emulations. 


The trace display command allows the user to examine collected trace data displayed 
in one of two modes: as ‘‘raw’’ data or disassembled with instructions appearing as 
8086 assembler mnemonics. 


Instructions in the trace buffer are counted by occurrences of queue status indicating 
‘*first instruction byte out of queue’’ (i.e., QSO=! and QS1=0). Since the 8086 
defines instruction prefix bytes as well as the first non-prefix byte as ‘‘first instruc- 
tion bytes’’, an 8086 instruction with one prefix byte counts as two instructions 

~ when using the MOVE or PRINT commands. However, if a PRINT command 
prints the requested number of instructions and ends up after a prefix byte but 
before the non-prefix instruction, it completes printing the entire non-prefix instruc- 
tion. When the user switches from frames to instructions mode, if the buffer pointer 
is not at the oldest or newest frame, then the pointer is moved to a “‘first byte out of 
queue’’ frame if it is not already pointing at one before beginning to MOVE or 
PRINT the requested number of instructions. 


Trace Display Mode 


The trace display mode controls the type of an entry to be displayed or located in the 
trace buffer. An entry can be a frame or an instruction. The initial trace display 
mode is INSTRUCTION. To set the trace display mode, use one of the following 
commands. 


TRACE = FRAME 
TRACE = INSTRUCTION 


To display an entry from the buffer, move the pointer to the desired entry and enter 


a PRINT command. However, it is not necessary to move the pointer if you use a 
PRINT ALL or PRINT-decimal command. 


Moving the Buffer Pointer 


The pointer movement commands are MOVE, OLDEST, and NEWEST. 

The command OLDEST (followed by carriage return) moves the pointer to the top 
of the buffer, in any trace display mode. The NEWEST command moves the pointer 
to the bottom of the buffer (i.e., after the last instruction or frame). ‘‘Top’’ refers to 
the oldest trace data, ‘‘bottom’’ refers to the newest trace data. 

The MOVE command has the following form: 


MOVE [[+ :: —] decimal | 
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The meta-term decima/ means any numeric quantity; if no explicit input-radix is 


given, the ICE-86A emulator assumes decimal radix. The value of decimal is the 


number of entries between the current pointer position and the desired position. 
Movement in a plus (+) direction is toward the bottom (newest point) of the buffer; 
if neither (+) nor (—) is entered, a foreward movement is assumed as the default. 
Movement in a minus (—) direction is toward the top (oldest point) of the buffer. 
The size of the move does not count the entry under the pointer when the MOVE 


command is given. 


For example, assuming FRAME mode, if the pointer is pointing at frame 100 and 
you issue the command ‘MOVE 10’, the pointer is moved to point to frame 110. 
Under the same initial conditions, if you issue the command ‘MOVE ~—10’, the 
pointer is moved to point to frame 90. If decimal-number is larger than the number 
of entries between the current pointer location and the bottom (for ‘+’) or top (for 
—’), the pointer is moved only to the bottom or top, respectively. In short, you 
cannot move the pointer outside the range of buffer locations. 


If the MOVE command has no number following it, ‘MOVE 1’ is executed. 
The trace display mode in effect controls the size of each move. Under FRAME 


mode, the command MOVE 10 moves down ten frames; under instruction, the same 
command moves down ten instructions. 


Displaying Trace Data 


~The PRINT command displays one or more entries from the buffer. This command 


has the form: 
PRINT [[+ ::-] decimal ]::PRINT ALL 


With (+) or no sign, decimal entries lower (toward the bottom) than the current 
pointer position are displayed. With (—), decimal entries above (toward the top) the 
current pointer position are displayed. The command PRINT without a decimal 
modifier is equivalent to PRINT 1 (one entry is displayed). 


The PRINT command displays the number of entries requested, then moves the 
pointer to point to the next entry just past the last one displayed. As an illustration, 
the commands: 


OLDEST 
PRINT 10 
PRINT 10 


are equivalent to the commands 


OLDEST 
PRINT 20 


The command PRINT ALL displays the entire trace buffer; PRINT ALL is 
equivalent to the commands: 


OLDEST 
PRINT 1022 


Trace Data Display Restrictions. Trace data does not contain byte reads from 
absolute memory locations 08H through OBH during Single Step Emulation. Reads 


from these locations are masked out of the trace buffer during Single Step Mode 
Pecause, when single-stepping, emulation is halted via Interrupt 2; and absolute 
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locations 08H through OBH contain the NMI Vector for Interrupt 2. Thus, during 
Single Step Emulation, the ICE-86A emulator must access locations 08H through 
OBH to enter and exit emulation. The ICE-86A software masks any reads from these 
locations so the system data will not take up room in the trace buffer. Consequently, 
user code which reads from these locations will also be masked from the trace buffer 
during Single Step Mode. 


TRACE Display Formats 


Display of Trace Data in Frames Mode 


The display has one frame per line. The header at the top of display has the follow- 
ing format (one line of display shown also): 


FRAME ADDR BHE/ STS QSTS QDEPTH DMUX MARK 
0000: 0002CH 0 F N 0 A 0 


How to interpret the Frames mode display: 
Headerentry Meaning 


FRAME Frame number; decimal number from 0000 to 1022. The colon 
separates the frame number from the next entry (ADDR). 


ADDR The 20-bit address in Hexadecimal radix (five digits plus suffix H) 
when DMUX = A (address frame). When DMUX = D (data 
frame), the last 4 digits (16 bits) of this number are data, and the 
first digit is status: S6, S5, S4, S3 (MSB to LSB). Bits S4 and S3 are 
the segment register used in effective address calculation: 


S4 S3 Segment Register 
0 0 ES 
0 1 SS 
] 0 CS or none 
1] 1 DS 
BHE/ Not Byte High Enable (displays ‘‘0’’ if high byte enabled, or ‘‘1’’ if 
not—note reverse logic as on 8086 pin). 
STS A one-character display of processor action, as follows: 
A Interrupt Acknowledge 
F Instruction Fetch 
H Halt 
I Input 
QO Output 
R Read (Memory) 
W Write (Memory) 
- Passive State 


_STS 1s valid on ADDR and DATA frames only (DMUX = A or D). 


QSTS Queue status; a one-character display, as follows: 
E Empty the queue 
F First byte of opcode executed out of queue 
N Nothing coming out of queue 
S Subsequent byte of opcode executed out of queue 
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QDEPTH > Number of bytes in queue (decimal poe Valid on ADDR 
| - frames only (DMUX = A). 


DMUX Type of frame; a one-character display as follows: 


A Address 
D Data 
Q Queue 


S Stop emulation 


MARK Displays a ‘‘1’’ if trace was turned off, then on again just before 
this frame (using tracepoint registers); otherwise displays ‘‘0’’. 


Display of Trace Data in Instructions Mode 


The display shows the disassembled instruction mnemonic and any operands, and 
any succeeding cycles. Each instruction combines several frames of trace data. 
Machine cycles after the instruction fetch are displayed four cycles per display line, 
using as many lines as necessary. 


First, we discuss the header and the instruction display. Display of cycles is discussed 
later on. The headers apply to the first line of the display entry—the line with the 
frame numbers. The Instructions mode header has the following format (two 
instructions are also shown): 


FRAME ADDR PREFIX MNEMONIC OPERANDS COMMENTS 

0006:  000E7H DEC CL 

0010:  000E9H MOV WORD PTR [0101H],BX 
00101H-W- 2CH-DS 00102H-W- 00H-DS 


Headerentry Meaning 


FRAME The (decimal) number of the frame where the first byte (or prefix) 
of the instruction came out of the 8086 execution queue. 


ADDR Address of first byte (or prefix) of instruction; 20-bit number in 
Hexadecimal radix (five Hex digits plus suffix H). 


PREFIX Prefix other than segment-override (LOCK, REPE, REPNE) if 
7 specified in assembly language, else blank. 


MNEMONIC_ MCS-86 assembler mnemonic for the instruction. 


OPERANDS _ Zero, one, or two operands separated by commas. The formats for 
the operand fields are discussed below. 


COMMENTS The word ‘‘;SHORT’’ for a JMP or CALL instruction to an 
address within the same segment of field bytes that contains the 
instruction’s address, or the word ‘‘;LONG’”’ for a branch to a dif- 
ferent segment, or the characters ‘‘;?’’ for an opcode value that 
does not correspond to a valid instruction. 


Operand Fields 


| 1. Registers: the iAP X-86 register identifiers are displayed: 


RAL, RAH, RBL, RBH, RCL, RCH, RDL, RDH, 
RAX, RBX, RCX, RDX — 
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Example (comments field omitted): 


FRAME ADDR PREFIX |= =MNEMONIC OPERANDS 
0003: 00206H MOV AL,BYTE PTR [0000H] 
00200H-R- 34H-DS 7 


Memory operands have the following display format: 


CS BYTE , »f BXE, , , ,f OI, , 5 yy EXXXXXH FL, 
DS \: WORD {PTR] [ J BP | [ysl] [ ] 
ES DWORD +XxXH 
SS ? —XxH 


- Example: the display ES:BYTE PTR [BX] [SI] [+01H] represents the operand 


BYTE ES:(BX + SI + 1) 
More examples showing memory operand display. 
FRAME ADDR PREFIX MNEMONIC OPERANDS 


0000:  FF380H ADD ES:BYTE PTR [BX] [SI], AL 
0025:  FF480H ADD ES:BYTE PTR [BX] [SI] [+01H], AL 
0050:  FF580H MOv AL, BYTE PTR [0001H] 


Notes on the memory operand format: 


e The first field is the segment register field. It is only displayed if the 
instruction has a segment-override prefix. 


e In the second field, an entry ‘‘? PTR’’ means that the type of the pointer 
cannot be determined from the context. 


Example: LEA AX,? PTR = [34A0H] 


e The base register (BX, BP) and index register (DI, SI) fields are not 
displayed for direct memory operands. When these fields are displayed, 
they are enclosed in brackets (shown as ‘|’ and ‘]’ in the format given 
earlier). 


e The last field is either a 16-bit unsigned (word) number, or a signed 8-bit 
(byte) number. The entry is displayed enclosed in brackets. 


e At least one of the last three fields (base register, index register, number) is 
displayed for any memory operand. 


Immediate data is displayed as a byte or word number, without brackets. 


Example: 
FRAME ADDR PREFIX MNEMONIC OPERANDS 
0932: FF391H TEST AL, 07H 


Labels for the JUMP and CALL instructions: 
e Within 128 bytes of current address—$ + xxH 


Example: 
0934: FF393H JE $-06H 
e Within same 64K segment as current address—$ + xxxxH 
Example: | 
0000: FFOOOH JMP $+1005H 
e Toa different segment—base:displacement 
Example: 7 
0978: FFFFOH : JMP FFO0:0096H 


Note: the first two labels represent ‘‘SHORT”’ (intra-segment) branches, the third is 
a ‘‘LONG’”’ (inter-segment) branch. 
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Display of Cycles in Instruction Mode. After the instruction mnemonic and 
operands are displayed, the display shows succeeding cycles performed by the cur- 
rent instruction. Four cycles are shown per line of display; the display uses as many 
lines as needed to show all cycles. 


The general format for cycles display is: 


address-status-data-segment 


Examples: 
© Read/Write: 
12345H-R- 34H-DS (8-bit read of data 34H from address 12345H using DS) 


45100H-W-7000H-SS (16-bit write of data 7000H to address 45100H using SS) 
e Input/Output: (no segment register; 16-bit address) | 
FFOOQH-!-01H (8-bit input of data 01H from port FFOOH) 
FFDAH-O-1234H (16-bit output of data 1234H to port FFDAH) 
¢ Interrupt Acknowledge: no address field, ‘‘A’’ for ‘‘acknowledge’’ status, 8-bit 
interrupt type. 


Example: 
FRAME ADDR PREFIX MNEMONIC OPERANDS COMMENTS 
0980: FF391H TEST AL,07H 
0982: FF393H JE . $-06H - SHORT 
0990: FF38DH. MOV DX,FFEAH 
0996: FF390H IN | AL,DX | 
FFEAH-I- 00H 
A- FFH 
A- FFH 003FCH-R-0000H-CS 003FEH-R-FFFFH-CS 000BAH-W-F246 
H-SS | 
000B8H-W-FFO0H-SS. 000B6H-W-0391H-SS 
Note that: 
a. The I cycle is part of the IN instruction; the rest of the cycles are the 
interrupt. 


b. The ‘‘A’’ cycle is traced twice; ignore the first one. 
c. Interrupt is type OFFH 
The five cycles after the ‘‘A’’ cycle are as follows: 
— Read IP of interrupt vector 
— Read CS of interrupt vector 
— Write flags to stack 


— Write old CS to stack 
— Write old IP to stack 


¢ Fetch cycles do not appear as oe: they are used to display the opcode 


mnemonic and operands. 


e Halt cycles never appear as cycles; they appear : as the mnemonic HLT. 


Gaps in Trace in Instruction Mode. In Instruction mode, a gap in trace data is 
shown as three asterisks (***). A gap in trace is produced by tracepolnts or by buffer 


overflow. 


A gap in trace data also is reflected by a MARK = 1 in Frames mode. 
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1011: FFOQEH 
1013: FFOAOH 


Extended Example of Trace Displays 


The following example (from SDK-86 Monitor) shows most of the features of trace 


displays discussed in this section: 


“ONTRACE=FF00:96 

*OFFTRACE=FFFF:0 

“ONT 

ONT=FFO96H A,1,0,H,F,R,W 

“OFFT 

OFFT=FFFFOH A,1,0,H,F,R,W 

“ENABLE TRACE CONDITIONALLY NOW ON 
“GO TILL FF00:9E EXECUTED 

EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=FF00:00A1H 


OPERANDS 
AL,DX 


AL,07H 
$-06H 
DX,FFEAH 
AL,DX 


AL,07H 
$-06H 
DX,FFEAH 
AL,DX 


AL,07H 
$-06H 
DX,FFEAH 
AL,DX 


AL,07H 
$-06H 
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COMMENTS 


> SHORT 
- SHORT 
‘ SHORT 


- SHORT 


SS,WORD PTR [0092H] 


SP,0050H 
BP,SP 


‘BUF 

BUF=03FDH 

*P-20 | 

FRAME ADDR PREFIX MNEMONIC 

0928:  FF390H IN 
FFEAH-I- 00H 

0932:  FF391H TEST 

0934: FF393H © JE 

0942: FF38DH MOV 

0948:  FF390H IN 
FFEAH-I- 00H 

0952:  FF391H TEST 

0954:  -FF393H JE 

0962:  —FF38DH MOV 

0968:  FF390H IN 
FFEAH-I- 00H 

0972:  FF391H TEST 

0974:  FF393H JE 

0982:  FF38DH MOV 

0988:  FF390H | IN 

| FFEAH-I- 00H : 

0992:  FF39IH- TEST 

0994:  FF393H JE 

1004:  FFO98H MOV 

| FF092H-R-0007H-CS 

1012; FFO9CH MOV 

1015: FFO9FH | MOV | 

*- TRACE TURNED OFF AT FFFF:0, BACK ON AT FF00:96, BREAK AT FF00:9E 

*BRO | | 

BRO=FFO9EH E 

*ONT 

ONT=FFO096H A,1,0,H,F,R,W 

*OFFT | 

OFFT=FFFFOH A,I,0,H,F,R,W 

*TRA=FRA 

*P-25 


FRAME ADDR BHE 
0996: BF398H 
0997:  FFFFOH 
0998:  22EFAH 
0999:  FFO98H 
1000: 2168EH 
1001: 2168EH 
1002:  2168EH 
1003:  FFOQAH 
1004: 20092H 
1005: 20092H 
1006: | FFO9CH 
1007: 250BCH 
1008:  250BCH 
1009:  FFO92H 
1010:  20007H 


1012: 28B00H 


MUAUNDIOVUMAUDANAUAAAATRANN-s 
OnNZZZHWHZoOnNZnNZynNZZZzM 


NWNNYNYNYNYNYNYYNNYWNMNMDY OO 


PUSFUFOUOFUOrFOUNDFOULFO 


STS QSTS QDEPTH DMUX MARK 


COCTCC CCC OCCOCCOOOAHA00 


6-33 


Emulation and Trace Control Commands 


6-34 


1014: 
1015: 
1016: 
1017: 
1018: 
1019: 
1020: 


22EECH 
22EECH 
FFOA2H 
21E8EH 
21E8EH 


_ FFOA4H 


20094H 


=ZzZNZ2NMV 


Cn Go G RO AS AO PO 


Orouordvuyo 
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Set TRACE Display Mode Command 


TRACE = FRAME 
INSTRUCTION 


Examples: 


TRACE = FRAME 
TRACE = INSTRUCTION 


TRACE A command keyword indicating that the mode of display 
for trace data Is to be set. 


FRAME A function keyword indicating that data in the trace 
buffer is to be displayed frame by frame. 


INSTRUCTION A function keyword indicating that data in the trace 
buffer is to be displayed by instruction. Each instruction 
is equivalent to one or more machine cycles. 


In the FRAME mode, trace data is displayed one frame per line, with fields for 
frame number, address/data, bus status, queue status, queue depth, type of frame 
(address, data or queue) and start/stop trace marker. 


In the INSTRUCTION mode, trace is disassembled with instructions appearing as 
8086 assembler mnemonics. All other cycle data other than instruction fetches, the 
address, status and data of the cycle are displayed. Memory fetches into the execu- 
tion queue and queue activity are not shown explicitly. Instead, they are used to find 
the instruction bytes that were executed when the instruction is taken from the 
queue. Whenever it is impossible to disassemble frames, immediately before or after 
a frame with the START/STOP trace marker set, the gap is indicated by a line con- 
taining three asterisks (‘‘***’’). In either mode, status appears as ‘“‘F’’, ‘‘R’’, ‘‘W”’’, 
“P?, O”’, ““H’’, or “SA”’ corresponding to the match status(es) set in the tracepoint 
register, and addresses are displayed as 20-bit numbers is the displacement of the 
address from that base. 
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636. 


ENABLE/DISABLE TRACE Command 


ber TRACE | conomionatty foo OF ii 


| DISABLE - 
Examples: 


ENABLE TRACE 


I NOW OFF | | 


ENABLE TRACE CONDITIONALLY 
ENABLE TRACE CONDITIONALLY NOW ON 
ENABLE TRACE CONDITIONALLY NOW OFF 


DISABLE TRACE 


ENABLE A command keyword that causes trace data collection to be 
conditionally or unconditionally enabled. 

DISABLE A command keyword that causes trace data collection to be 
disabled. 

CONDITIONALLY A command modifier that specifies that trace will be turned on 
whenever the ONTRACE register matches and turned off 
whenever the OFFTRACE register matches. 

NOW ON Indicates that trace is turned on for the beginning of the next 
emulation (see Note). | 

NOW OFF Indicates that trace is turned off for the beginning of the next 
emulation (see Note). 

TRACE Command modifier denoting that trace is to be 
enabled/disabled. | | 

NOTES 


If ENABLE TRACE CONDITIONALLY, the tracepoints will inadver- 
tently match and turn trace on or off when entering emulation if the trace- 
point is set to match on a Fetch at address 00008 or 00009, and when exiting 
emulation if the tracepoint is set to match on a Read at address 00008 or 
00009. Conditional trace should not be setup ONTRACE/OFFTRACE 
tracepoints at memory locations 00008 or 00009, as the ICE-86A emulator 
uses these two memory locations when emulation is broken. 


If neither NOW ON or NOW OFF is selected (i.e., ENABLE TRACE 
CONDITIONALLY), trace is left in its current state. 


Upon normal termination of code execution with string operations, the 
ICE-86A emulator appears to hang (no prompt) immediately after display 
of CS:IP. It may take up to 40 seconds for the prompt to appear. No such 
hanging occurs when trace collection is disabled. The cause of this hanging 
is connected to the repetitive nature of string operations and the size of the 
trace buffer. The maximum 1021 allowed frames of trace information in the 
trace buffer can easily be surpassed when collecting trace information dur- 
ing execution of string instructions. The original opcode fetch of the string 
instruction is beyond the 1021 frames of trace information. Trace collection 
and CPU operation are out of sync. The trace buffer may be full, but there 
is no trace. This is the normal trace operation for string operations. 
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Display TRACE Command 


TRACE 


Example: 


TRACE 


TRACE 
A command keyword that, if entered from the keyboard as a 
single token, causes the current TRACE mode (FRA for 


FRAME or INS for INSTRUCTIONS) to be displayed. 


NOTES 


Execution breakpoints are complicated by the need to trace the 8086 queue 
Operations, and thus do not guarantee that execution will be terminated 
immediately after the specified instruction. The ICE emulator may slip past 
the breakpoint instruction and stop at the next instruction. This slippage is 
dependent on the current depth of the queue when the breakpoint instruc- 
tion requires only two clock cycles for execution. Due to the complexity of 
the breakpoints and exact timing uncertainties, the ICE emulator will not 
detect this slip. The user may determine that the slippage has occurred by 
examining the trace data and comparing the next-to-last instructions exe- 
cuted to the potential break conditions. 


Trace data does not display byte reads of absolute memory locations 08H 
through OBH following single-step execution. Absolute memory locations 
08H through OBH contain the NMI vector for Interrupt 2. During single- 
step mode, which is the execution of single instructions halted via an Inter- 
rupt 2, the ICE-86 emulator accesses locations 08H and 09H to enter and 
exit emulation. The ICE software masks these reads out to conserve space in 
the trace buffer. The software does not distinguish between ICE emulator 
reads and user reads of these locations. As a result, user code reading these 
locations during the single-step mode is also masked out. The instructions 
are executed but do not appear in the trace data. 
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- MOVE, OLDEST, and NEWEST Commands 


MOVE [[+::—|decima!/] 
OLDEST 
NEWEST — 

Example: 

MOVE 

MOVE +6 

MOVE -11 

OLDEST 

NEWEST 


MOVE 


decimal 


OLDEST 


NEWEST 


e 


A command keyword that moves the buffer pointer one 
or more entries forward (toward the most recent entries) 
or backward (toward the earliest entries). An entry is a 
frame or instruction, depending on the TRACE mode in 
effect. 


A unary operator specifying a forward movement. Plus is 
the default. 


A unary operator specifying a backward movement. 
A number, evaluated in decimal radix (if no explicit 
suffix is given), that gives the number of entries to be 


included in the MOVE. 


A command keyword that moves the pointer to the 
earliest entry in the buffer. 


A command keyword that moves the pointer to the latest 
entry in the buffer. 
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[[ + ::-]decimal] 


Example: 
PRINT 
PRINT ALL 
PRINT +5 
PRINT 5 
PRINT —10 


PRINT 


ALL 


decimal 


A command keyword calling for a display of one or more 
entries from the trace data buffer. The entries are 
displayed as frames or instructions, depending on the 
current trace mode. 


A function keyword indicating that the entire trace buffer 
contents are to be displayed. 


A unary operator directing the display of decimal entries 
below (entered later then) the current buffer pointer loca- 
tion. See DISCUSSION for details. Plus is the default. 


A unary operator directing the display of 
decimal-number entries above (entered earlier than) the 
current buffer pointer location. See DISCUSSION for 
details. 


A numeric constant, evaluated in decimal suffix, giving 
the number of entries to be displayed. 
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CHAPTER 7 
INTERROGATION AND 
UTILITY COMMANDS 


Chapter 7 contains discussions, examples, and syntax summaries for each of the 
ICE-86A interrogation and utility commands. 


The following brief outline of Chapter 7 shows how the interrogation and utility 
commands have been clasified. 


Utility Commands Involving ISIS-II 


ICE86 Command 
EXIT Command 
LOAD Command 
SAVE Command 
LIST Command 


Number Bases and Radix Commands 


Set or Display Console Input Radix Commands 
Set or Display Console Output Radix Commands 


Hardware Register.Commands 


Set Register Command 

RESET HARDWARE Command 
Set or Display RQ/GT Command 
Display BUS Command 


Memory Mapping Commands 


MAP DISK Command 

MAP INTELLEC Command 
Set MAP Status Command 
Display MAP Status Command 
RESET MAP Command 


Set Memory and Port Content Commands 


Set Memory Command 
Set Input/Output Port Command 


Symbol Table and Statement Number Table Commands 


DEFINE Symbol Command 

Display Symbols Command 

Display Statement Numbers Command 

Display Modules Command 

Change Symbol Command 

REMOVE Symbols Command 

REMOVE Modules Command 

TYPE Command 

Set DOMAIN Command 

ENABLE/DISABLE SYMBOLICALLY Command 


| 
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Display Commands 


Display Processor and Status Registers Command 
Decode CAUSE Command 

Display Memory Command 

Disassembly Command 

Display 1/O Command 

Display STACK Command 

Display Boolean Command 

Display NESTING Command 

Evaluate Command 


Utility Commands Involving ISIS-II 

The Intel Systems Implementation Supervisor (ISIS-II) is the diskette operating 
system for the Intellec Microcomputer Development System. The ICE-86A emulator 
runs under ISIS-II control and can call upon ISIS-II for file management function. 


The following commands are included in this section: 


Command Purpose 
ICE86 Load ICE-86A program from diskette. 
EXIT Return control to ISIS-Il. 
LOAD Load user program into memory accessed by the ICE-86A emulator. 
SAVE Copy user program from memory onto diskette. 
LIST Copy ICE-86A emulation output to printer or file. 
Discussion 


ICE-86A commands can use ISIS-I] painaines to direct ISIS-II to a desired disk file 
or other output device. 


For disk files, the format of pathname is as follows. 
:drive: filename 

The entry :drive: stands for one of the references to ISIS disk drives, in the form: 
-Fn: where nis the drive number from 0-9 


Refer to the JSIS-II User’s Guide for the various CONHEUTAHONS aowes for dif- 
ferent kinds of disk drives. 


The entry filename must follow the second colon (after drive) without any interven- 
ing spaces. A filename has the following components. 


identifier |.extension | 


The entry identifier is a name assigned by the user, and is made up of one to six 


alphanumeric characters. The extension is an optional part of the filename, con- 


sisting of one to three alphanumeric characters preceded by a single period. The 
extension must be used if it is present in the directory listing of the file on the 
diskette. If used, the extension follows the identifier without any spaces. Some 
extensions (e.g., .BAK) are assigned by system processors; others can be assigned at 
the desire of the user. An extension provides a second level of file identification; it 
can be used to identify. different versions of the same program, or to give sup- 
plemental information about the file (e.g., author, data, version). 


ICE-86A 


ICE-86A 


Interrogation and Utility Commands 


Fully compiled or assembled programs ready to run (emulate) do not have system- 
assigned extensions, although they may have extensions assigned by the user. 


For devices other than disk files, the format of pathname is as follows: 
:device: 


The following devices are commonly accessed in ICE-86A commands: 


:Device: Output Device 

“LP: Line printer 

‘HP: High-speed tape punch 
:TO: Teletypewriter printer 
:CO: Console display 


For more information on ISIS-II filenames and device codes, refer to the JS/S-I/ 
System User’s Guide. 


The ICE86 command, entered after an ISIS-II prompt, directs ISIS-II to load the 
ICE-86A program from the specified diskette drive into a reserved area in Intellec 
memory. The ICE-86A emulator begins operation as soon as it is loaded, initializing 
its hardware and program variables, and signaling readiness to accept ICE-86A 
commands by displaying an asterisk prompt. 


The EXIT command ends the emulation session and returns control to ISIS-II. The 
command issues a hardware reset before exiting. 


~ The LOAD command loads the object code from the named file and drive into the 


areas of memory specified by the memory map. Modules are loaded in the order of 
their appearance in the source file. The modules’ names, symbols, and statement 
numbers are placed in reserved areas of Intellec memory. Symbols and statement 
numbers are grouped into tables by module in the order in which they appear. Both 
a base value and a displacement value are loaded for all symbols and statement 
numbers. Any symbol that has no type information is given no type specification in 
the symbol table. If no exclude modifiers are included in the command, module 
names are loaded into the ICE-86A module table in the order in which they appear 
following any module names already in the table, symbols and their types (if pre- 
sent) local to each module are loaded into that module’s symbol table in the order in 
which they appear, and statement numbers local to each module are loaded into that 
module’s statement table (for PL/M 86 programs) in the order in which they appear. 


The command can include one or more modifiers to control what is to be loaded. No 
modifier may be named twice in the same load command. If NOCODE is included, 
the program code is omitted from the load, e.g., it is already in ROM. If NOLINE is 
included, the program statement number table is not loaded. If NOSYMBOL is 
included, the program symbol table is not loaded. Any combination of one, two, or 
three of these modifiers may be included, although the command with all three 
modifiers represents a ‘‘null’’ command. 


NOCODE, NOSYMBOL, and NOLINE can be followed by the SELECTING 


modifier. The SELECTING modifier is intended to aid those users who are unable 
to fit their entire symbol table in memory. The user is allowed to specify which 
modules’ symbols are to be loaded. The SELECTING keyword must be followed by 
a module-name, one or more module-ranges (module-name TO module-name), or 
one or more module-ranges followed by a module-name. When a module-name is 
given, the ICE-86A emulator begins loading symbol information (symbol names, 
addresses, and type specifications) when it reads from this module, and continues 
until end of file. When a module range is given, the ICE-86A emulator begins 
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loading symbol information when it reads from the first module in the range, and 
continues through the last module in the range. A warning is issued if the ICE-86A 
emulator reads an end-of file before encountering the end of a range. The 
SELECTING modifier does not affect the loading of object code. 


The SAVE command copies the user program currently loaded from memory onto 
the specified file and drive. If the diskette installed on the given drive does not have 


the named file in its directory, ISIS-II creates the file and opens it for write. If the 


named file does exist on the diskette, the file is overwritten and the previous contents 
are lost. If no explicit drive number is given, drive 0 is assumed. 


The command can include one or more modifiers to control what is to be saved. If 
NOSYMBOL is included, the symbol table is not copied from memory to diskette. If 
NOLINE is included, the statement number table (for PL/M-86 programs) is not 
saved. The modifiers NOCODE and partition are mutually exclusive: if one is used, 


the other may not be included. If NOCODE is included, the program object code 1s 


not copied to diskette. If partitions are included, only the code stored in the memory 
addresses in the partitions (ranges of addresses) are saved. If neither NOCODE nor 
Partition appears in the command, any code between the lower and highest 
addresses in each 1K segment that has been previously loaded is saved. If no code 
has been loaded, no code is saved. When more than one modifier is used, separate 
them with spaces. No modifier may be used twice in the same SAVE command. The 
SAVE operation does not alter the program code, symbol table, or statement 
number table in memory. 


The LIST command saves a record of the emulation session, including high-volume 
data such as trace data, on a hard-copy device or on a diskette file in addition to 
sending it to the console. Only one pevice or file other than the console can be 


- specified (active) at a given time. 


The initial device is :CO:, output to the console. Other devices that can be specified 
are a line printer (:LP:), high-speed Paper tape punch (:HP:), and teletypewriter 
printer (:TO:). 


Instead of a hard-copy device, a diskette file can be specified. If the output is to a 
diskette file, the file is opened when the LIST command is invoked, and output is 


stored from the beginning of the file, writing over any existing data. Specifying a 


new file or device in a later LIST command closes any existing open file and avoids 


Over-writing any more data. Specifying the same file in a later LIST causes the delete 


of the file and starting over. 


“When LIST is in effect (with a device or file other than :CO:), all output from the 


ICE-86A emulator, including system prompts, commands, and error messages, is 
sent both to the named device or file and to the console display. To restore output to 
the console only (no other device), use the command LIST :CO:. 
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ICE86 Command 
[:drive] ICE86 [WORKFILES(-alt. drive:)] 
Example: 


*F1:ICE86 
:F1:ICE86 WORKFILES(:F2:) 


:drive: The number of the diskette drive containing the ICE-86A software 
diskette. The number is preceded by the letter F and enclosed in 
colons. This drive is also the default drive for the ICE temporary 
workfile. 


ICE86 The name of the ICE-86A program file under ISIS-II. The filename 
follows the second colon without any intervening spaces. 


WORKFILES Control keyword specifying that an alternate disk drive is to be 
used for the ICE temporary workrfile. 


-alt. drive: The number of the diskette drive containing the diskette where the 
temporary workfile 1s to be stored. The number is preceded by the 
letter F and enclosed in colons. 


NOTE 

Inspect the diskette containing the ICE-86A program prior to loading into 
the diskette drive. If the WORKFILES control is specified, the diskette con- 
taining the ICE-86A program may be write protected. If the WORKFILES 
control is not specified, the diskette containing the ICE-86A program must 
not be write protected or an ISIS ERR24 (write protect) will result. Ensure 
that the diskette has a write-enable tab covering the write protect slot on the 
square plastic diskette housing. 
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EXIT Command 
EXIT 
Example: 
EXIT 
EXIT A command keyword that returns control from the ICE-86A 


emulator to ISIS-II. The command issues a hardware reset before 
exiting, and leaves the file used for DISK-mapped memory intact. 
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LOAD Command 


LOAD|(:drive:|filename | NOCODE 


NOSYMBOL 7 ...[SELECTING module-partition |, module-partition)...| 
NOLINE 
module-partition = | module-name 
module-name TO module-name 


Examples: 


LOAD :FO:TEST.VR1 

LOAD :F1i:MYPROG NOLINE 

LOAD :F2:COUNT. ONE NOCODE NOLINE 

LOAD :F3:NEWCOD NOSYMBOL 

LOAD :F0:TEST.VRI SELECTING ONE TO FIVE, SEVEN 


LOAD 


‘drive: 
filename 
NOCODE 
NOSYMBOL 
NOLINE 
SELECTING 
module-name 


TO 


A command keyword that loads the software on the given file and 
drive into the combination of prototype and Intellec memory 
specified by a previous MAP command. 


The diskette drive (:FO:, :F1l:, :F2:, or :F3:) that contains the target 
file. If no drive is given, :FO: (drive 0) is the default. 


The name of the desired program as compiled or assembled, linked, 
and located. The filename follows the second colon with no 
intervening spaces. 


A modifier specifying that program code is not to be loaded. 


A modifier specifying that the program symbol table is not to be 
loaded. 


A modifier specifying that the program line number table (for 
PL/M-86 programs) is not to be loaded. 


A modifier that denotes that a range of modules whose symbols are 
to be loaded is to follow. 


A sequence of continuous alphanumeric characters that references 
a program module. | 


A connector that denotes that a module name is to follow that — 


defines the end of a range of modules. 


NOTE 


In this command, module-name is not preceded by two periods as it is in 


other cases. 


When compiling, linking and locating PL/M-86 programs on a Series III 
8086 based development system (as opposed to running under ISIS-II on an 
8085) the NOIC option must be used on the LOCATE command line. 
Otherwise, the LOCATE program produces a block of initialization code | 
which is understood by the Series III monitor but not by the ICE-86A 
emulator. This initialization code will prevent ICE-86A from LOADing the 


program. 
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SAVE [:drive:]filename [ NOCODE — 


Examples: 


7 [partition|,partition |] 


SAVE. :F1:TEST 

SAVE. :FO:MYPROG 0800 TO OFFF NOLINE 

SAVE :F2:COUNT.TWO NOLINE NOSYMBOL 

SAVE :F3:NEWSYM NOCODE NOLINE 

SAVE :F1:TEST #1 TO #50,..SUBR #1 TO ..SUBR #20 


SAVE 


‘drive: 


filename 


NOCODE 


partition 


NOSYMBOL 


NOLINE 


The command keyword that directs the ICE-86A emulator to write 
the designated software elements to the indicated file and drive. 


The diskette drive (:FO:, :Fl:, :F2:, :-F3:) holding the diskette that is 


to contain the saved software. If no explicit drive number is given, | 


drive 0 is the default. 


The name of the file that is to receive the saved information. The 


name of the file, including the extension if present, must follow the 
rules for naming files under ISIS-II. The filename immediately 
follows the second colon. If the filename does not exist on the 
designated diskette, ISIS-II creates the file and opens it for write. If 
it does exist, the current file is destroyed. 


A modifier specifying that program code is not to be saved. 
A construct specifying a range of one or more contiguous locations 
in memory; the contents of the specified locations are saved, but 


code in other locations is not copied. 


A modifier specifying that the symbol table is not to be saved to 
diskette. | 


A modifier specifying that the line number table (for PL/M-86 
programs) is not to be saved. 
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LIST Command 


LIST | :device: | 
[:drive: |filename | 


Examples: 
LIST :LP: 
LIST :CO: 
LIST :FI:ICEFIL 
LIST The command keyword directing all ICE-86A output to be sent to 
the specified device or file, and to the console. 
:device: An ISIS-II device code, indicating a hard-copy output device to 
receive the output. 
:drive: The diskette drive holding the diskette on which output is to be 
written. If no explicit drive is given, drive 0 is assumed. 
filename The name of the file on the target diskette. The filename 


immediately follows the second colon without intervening spaces. 
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Number Bases and Radix Commands 


ICE-86A commands and displays involve several different number bases (radixes). 
This section describes the various radixes used by the ICE-86A emulator and the 
commands used to control some of them. Most radixes are set by the ICE-86A 
emulator and cannot be changed, but others are under your control: 


This section gives details on the following commands: 


_ Command 7 Purpose 
SUFFIX Set or display console input radix. 
BASE Set or display console output radix. 
Discussion 


The commands given in detail in this section refer to the radixes used for console 
input and console output. 


Console Input Radixes: SUFFIX Command 


Any number entered from the console can include an explicit input radix. An 
explicit input radix consists of one of the following alphabet characters appended 
directly to the number as entered. 


Explicit Example — Radix Specified 
Radix 
Y 1001Y Binary (base 2) 
Q,O 11Q Octal (base 8) 
T OT Decimal (base 10) 
H 9H Hexadecimal (base 16) 
K 3K Multiple of 1024 decimal © 


The implicit input radix is the base used by the ICE-86A emulator to interpret 
numbers entered from the console without an explicit radix. 


To display the current implicit input radix, enter the command token SUFFIX 


followed by a carriage return. The implicit input radix can be Y, Q, O, T, or H, as 
defined earlier. The initial implicit radix 1s hexadecimal. | 


You can change the implicit input radix by entering a command with the form 
SUFFIX = suffix , where suffix is any of the characters Y, Q, T, or H. This 
SUFFIX command can be used where several numbers are to be entered in the same 
radix. 


Note that K (multiple of 1024) cannot be specified as an explicit input radix. 


For some kinds of entries from the console, the implicit input radix is always 
decimal (T). Entries with implicit decimal radix are: 


e Numbers entered after MOVE and PRINT keywords. © 
e Program statement numbers. 

e Value in COUNT command. 

e Timeout value in RWTIMEOUT 

e Segment numbersin MAP. _ 
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An explicit radix always takes precedence over the implicit radix. If the digits in the 
number entered cannot be interpreted in either the explicit or the implicit radix, an 
error message is displayed. 


Console Output Radixes: BASE Command 


Numeric information, such as memory and register contents, and data, is displayed 


in the current console output radix. The console output radix can be one of the 
following. | 


Output Radix Specified 
Radix 
Y Binary 
Q,O Octal 
T Decimal 
H Hexadecimal 
ASCII ASCIll character for each byte 


The initial output radix is hexadecimal (H). 


To display the current console output radix, enter the command token BASE 
followed by carriage return. The display consists of a single character, Y, Q, O, T, 
H, or A (for ASCII). 


You can change the console output radix by entering a command with the form 
BASE = base, where base is one of the single characters Y, Q, O, T, or H, or the 
token ASCII. Once the radix is set with a BASE command, it stays in effect until 
another BASE command is entered. 
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Set or Display Console Input Radix Commands 
SUFFIX 
SUFFIX = Y::Q::0::T::H 
Examples: 
‘SUFFIX - 
SUFFIX = Y_ 
SUFFIX A command keyword referring to the implicit console input radix. 
te token SUFFIX alone displays the current setting (Y, Q, T, or 


= The assignment operator, indicating that the new setting is to 
follow. | 


Y Binary radix. 
Q,O Octal radix. 
T Decimal radix. 


H | Hexadecimal radix. 
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Set or Display Console Output Radix Commands 


BASE 


BASE = Y::Q::0::T::H::ASCII 


Examples: 
BASE 
BASE =Q 


BASE 


ASCII 


A command keyword referring to the system console output radix. 
The token BASE alone displays the current setting (Y, Q, T, H, 
or A). 


The assignment operator, indicating that the new setting is to 
follow. 


Binary radix. 

Octal radix. 
Decimal radix. 
Hexadecimal radix. 


Each byte represented by its corresponding ASCII character, 
without separators. 
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Hardware Register Commands 

This section presents the keywords used in the ICE-86A emulator to refer to the 
following types of hardware registers and signals. 

e 8086 Processor Register 

e §€©>.8086 Status Flags 

e ICE-86A Status Registers 

e 8086 Pin Signals 


The following commands that refer to hardware registers and signals are discussed 
in this section: 


Command | | - Purpose © 

Set Register Set (change) the contents of any of the writeable 8086 
_ registers. 

RESET HARDWARE Reset ICE-86A hardware to initial state. 

Set or Display RQGT Specifies whether Request/Grant lines operate continuously 


or only during emulation time. 


Display BUS Command ___ Displays current master of the system bus. 


Discussion 


Tables 7-1 through 7-6 cow the tokens used to refer to any 8086 8-bit EEE ISChs 16-bit 
register, or pin signal. 


Meta-term Class of tokens 
general-register 16-bit and 8-bit work registers 
pointer-register 16-bit pointer registers 
index-register 16-bit index registers 
segment-register 16-bit segment reference registers 
status-register 8- and 16-bit status registers 
pin-reference 8086 pin signals 
flag-reference 8086 status flags 


Table 7-1. 8086 General Registers 


8086 Register and Interpretation 


16-bit Accumulator 

High 8 bits of Accumulator 
Low 8 bits of Accumulator 
16-bit Base Register 

High 8 bits of Base Register 


Low 8 bits of Base Register 
16-bit Count Register 

High 8 bits of Count Register 
Low 8 bits of Count Register 
16-bit Data Register 

High 8 bits of Data Register 
Low 8 bits of Data Register 
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Table 7-2. Pointer Registers 


8086 Register and Interpretation 


SP 16-bit Stack Pointer 
BP 


Table 7-3. Index Registers 


8086 Register and Interpretation 


Sl 16-bit Source Index | 
DI 16-bit Destination Register 


Table 7-4. Segment Registers 


8086 Register and Interpretation 


CS 16-bit Code Segment Register 
DS | 

| SS 
ES 


Table 7-5. Status Registers 


16-bit Instruction Pointer Register 


16-bit Base Pointer 


16-bit Data Segment Register 


16-bit Stack Segment Register 


16-bit Extra Segment Register 


16-bit Flag Register 
CAUSE (Read only) | 8-bit Cause of last break in emulation 
OPCODE (Read only) 8-bit Previous opcode executed 
PIP (Read only) | 16-bit Previous Instruction Pointer Register 
TIMER (Read only) | Low 16 bits of emulation timer 
HTIMER (Read only) High 16 bit of emulation timer 


BUFFERSIZE (Read only) 16-bit trace buffer size Register 
(Displayed in decimal only) 


UPPER (Read only) Highest available address in ICE-86A 
| workspace 


LOWER (Read only) Lowest available address in ICE-86A 
workspace 
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Table 7-6. Pin References 


READY | 


NMI 
TEST 
HOLD 
RESET 
MN/MX (minimum/maximum configuration) 
INTR 
RQGT, BUS | RQ/GT0, RQ/GT1 (HOLD, HLDA) 


Table 7-7 Flag References 


reference Flag | 


Auxiliary-carry out of low byte to high byte 
Carry or borrow out of high byte 
Direction of string manipulation instruction 


Interrupt-enable (external) 


Overflow flag in signed arithmetic 


Parity 
Sign of the result of an operation 


Trap used to place processor in single step 
mode for debug 


Zero indicates a zero value result of an 
operation 


To set (change) the content of one of the processor registers, use a command with 
the form: . 


reference = expr 


Where expr is a numerical constant or numerical expression giving the desired new 


contents. Each of the registers that can be changed with this command has a definite. 


size (16, 8, or | bits). If the new contents represents fewer bits than the destination 


register, the bits are right-justified in the register, and the remaining bits are set to — 


zero. In other words the ICE-86A emulator assumes that the quantity represents the 
lowest- order mits, and sets any unspecified high-order bits to zero. . 


The RESET HARDWARE command is used to restore the ICE- 86A hardware to’ 


the initial program load condition. One use for this command might be to reset the 


hardware when reconfiguring. The EXIT command includes the RESET 
HARDWARE Furtction. 
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When a RESET HARDWARE command is issued, the ICE-86A emulator attempts 
to reset the hardware without disturbing any 1nternal controls or user-specified setup 
(breakpoints, map, or enable/disable trace conditionally). If this attempt is suc- 
cessful, the ICE-86A emulator returns a prompt to the user immediately: 


*CLOCK = INTERNAL 


*RESET HARDWARE ‘This reset will not encounter any problems. 
. ‘Prompt appears immediately, no internal 
: ‘setup affected. 


The user may now continue his processing. 


If, however, this attempt is unsuccessful, the ICE-86A emulator will warn the user 
that it is beginning to reinitialize the hardware. It then attempts to reset the hard- 
ware by using initialization procedures and then restoring internal controls and 
setup to the pre-reset state (trace, however, cannot be restored to its previous state, 
and will be enabled unconditionally). Although no internal registers or flags are 
changed, the integrity of user memory, ICE memory, and current disk-mapped 
memory cannot be guaranteed. If this attempt to reset the hardware is successful, 
the ICE-86A emulator will return a warning to the user that the hardware has been 
initialized followed by a prompt. The user may then examine memory for integrity, 
reload memory or continue processing. 


NOTE 


If the above reinitialization is successful, the ICE-86A emulator may 
require up to approximately 30 seconds to fully restore the map. 


If the ICE-86A emulator detects an error during this attempt, it will return an error 
message and a prompt to the user. No warning that the hardware has been 
reinitialized will be returned. The user should attempt to resolve the error condition 
and MUST reissue the RESET HARDWARE command. The ICE-86A emulator 
will then go through the reinitialization as described above. The following example 
illustrates the procedures required to respond to error conditions: 


*CLOCK = EXTERNAL | ;This command forces an error condition. 

ERR 40:NO USER CLOCK ;Error response. 

*RESET HARDWARE ;Not able to reset, tries to reinitialize. 

WARN C8:REINITIALIZING - FAULT 

ERR 40:NO USER CLOCK ;Reports an error and no warning that hardware 


* 


was reinitialized; thus, reinitialization was not 
;able to complete. The user must clear the 
;error condition and then reset the hardware 
;again in order to get the hardware intoa 
*CLO = INT ;known state. Clears the error condition, must 
*RESET HARDWARE reset again. This reset must clear the 
;incomplete reset from above. 

WARN C8:REINITIALIZING - FAULT 

WARN C6:HARDWARE REINITIALIZED ;Note that the user is informed that the 
;hardware has been reinitialized and that the 
;user specified setup (map, breakpoints, etc.) 
;has been restored. Memory contents (ICE 
;memory, user memory, and current disk- 
;mapped memory) cannot be guaranteed. The 
;user must verify the contents or reload his 
;code and data. 


* 


* 


* 


The RESET HARDWARE signal pulse may be cut short by an emulation 
halt, with undefined results. The reset pulse should be a minimum of four 
clock cycles in duration. If an emulation begins or stops while the reset 
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signal level is being changed, there is no guarantee to the user as to the 
validity of the register contents or flags. RESET HARDWARE signal 
pulses are not saved when an emulation halt occurs, and are not resyn- 
chronized when emulation recontinues. Frequent emulation halts in con- 
junction with Reset Pin level changes, of course, will heighten the chance of 
entering this undefined state, and should be avoided. (There is a four clock 
cycle window while entering or exiting emulation during which the Reset 
Pin should be stable to assure predictable behavior.) 


The INITOUTY line on the ICE-86A buffer box is activated by the RESET 
HARDWARE command. This signal (active low) can be used to reset user hardware 
working with the 8086 such as the 8087 NDP or the 8089 IOP. See the section on 
‘*Buffer Box Signals’’ in Chapters | and 2 for more information. 


The 8086 processor can operate in minimum or maximum mode. In minimum mode, 
requests for the bus are made through the HOLD and HLDA lines. In maximum 


mode, these lines are relabeled RQ/GTO and RQ/GT1I, respectively (referred to 


together as the “‘Request/Grant lines’’), and are used to support coprocessor 
requests for the bus. 


Typical applications of the Request/Grant lines would be expansion of the 8086 pro- 
cessor’s arithmetic abilities to include floating point calculations by sharing the bus 
with an 8087 Numeric Data Processor, or providing more efficient handling of I/O 
by sharing the bus with an 8089 Input/Output Processor. See The 8086 Family 


~ User’s Manual Numerics Supplement, Manual Order Number 121586, for material 


on the use of the 8087 NDP as a coprocessor. The RBF-89 Real-Time Breakpoint 


Facility is a software superset of the ICE-86 emulator that aids in designing applica- 


tion systems based on an 8086 CPU used in combination with an 8089 IOP. See the 
8089 Real-Time Breakpoint Facility Operating Instructions, Manual Order Number 
162490, for material on this facility.) 


NOTE 


The request/grant operation is a three-phase sequence. First, the 
coprocessor desiring the bus pulses a request/grant line, either RQ/GTO or 
RQ/GT1. Second, the 8086 CPU returns a pulse on the same line indicating 
that it is relinquishing the bus to the querying device. Third, when the 
coprocessor has finished with the bus, it sends a pulse to the 8086 CPU 
indicating that it may resume control. For the physical 8086 processor, 
these signals are recognized 85 ns. into their clock cycles; for the emulated 
8086 processor (that is, the ICE-86A module), however, these signals are 
recognized after 100 ns. 


The Set RQGT Command allows the user to specify whether the Request/Grant 
lines operate continuously in maximum mode or only when the ICE-86A emulator is 
performing emulation. The syntax of the command is 


RQGT = CONTINUOUS 
EMULATIONTIME 


If RQGT is set to CONTINUOUS, then the ICE-86A emulator can respond to bus 
requests from coprocessors whether in Emualation mode or Interrogation and 
Utility mode. If RQGT is set to EMULATIONTIME, then the emulator will not 
respond to bus requests unless it is in Emulation mode. Pending requests are 


‘remembered and granted when the ICE-86A emulator next performs emulation. 


Initially, RQGT is set to EMULATIONTIME. | 
NOTE 


The ICE-86A emulator’s response to bus requests is delayed by 
one clock cycle, whether RQGT is set to CONTINUOUS or 
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EMULATIONTIME. There will always be a minimum of one clock cycle — 
between the Request and Grant signals for the emulator, whereas the 8086 
processor alone could drive the signals back to back. This can be critical to 
user’s design. Also, the ICE-86A emulator tristates (surrenders the bus) one 
cycle earlier than the 8086 processor, thereby reducing the possibilty of bus 
contention. 


When in minimum configuration, the HOLD and HLDA lines are always enabled. 
That is, they are capable of receiving and responding to requests for the bus whether 
the ICE-86A emulator is in Emulation or Interrogation and Utility mode. 


The user can display the state of RQGT by typing that keyword. The user can also 
display the current holder of the bus by typing the command BUS. The system will 
respond by displaying the characters ‘BUS=8086,’ ‘BUS=HLDA,’ or ‘BUS=CH 0’ 
or ‘BUS=CH 1,’ which correspond, respectively, to either the 8086 processor con- 
trolling the system bus, the device connected to the HOLD line controlling the 
system bus (only in minimum mode), or one of the devices on either of the 
Request/Grant channels controlling the system bus (only in maximum mode). 


The physical 8086 interrupt acknowledge sequence consists, in part, of two 
INTA bus cycles separated by two idle clock cycles; the address/data bus 
floats from T1 of the first bus cycle until T2 of the second bus cycle. The 
emulated 8086 CPU—that is, the ICE-86A module—does not precisely 
follow this sequence. The address/data bus is active for 20 to 30 
nanoseconds at approximately the end of the first bus cycle and the start of 
the second bus cycle. Therefore, the operator should avoid trying to access 
the address/data bus with any other device during this time period. 


Due to the capacitive loading factor on the RQGT pin, a load exceeding 15 
picofarad cannot be placed on the pin, 1.e., no more than one logic probe 
can be placed on the pin. If a problem is detected with the RQGT pin in 
local mode (using an 8087), a 3k ohm pull-up resistor should be put on the 
RQGT line to solve the problem. | 
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Set Register Command 
reference = contents ee 
Examples: 
RAX = 0000H 
IP = F23AH 
IP=IP +1 
RDL = FFH 
CS = WORD .SAM 
reference The keyword name of any of the writable registers, as follows: 
general registers (see Table 7-1). 
pointer registers (see Table 7-2). 
index registers (see Table 7-3). 
segment registers (see Table 7-4). 
status registers (see Table 7-5). 
= The assignment operator. 


contents A numeric expression. 
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RESET HARDWARE Command 
RESET HARDWARE | 
Example: 
RESET HARDWARE 
RESET A command keyword restoring its object to a reset condition. 


HARDWARE A function keyword restoring ICE-86A hardware to the reset 
- condition that occurs after the initial ICE-86A invocation. 


NOTE 


The INITOUT/ line on the ICE-86A buffer box is activated by the RESET 
HARDWARE command. This line can be used to reset user hardware 
working with the 8086, such as the 8087 NDP or the 8089 IOP. See the sec- 
tion on ‘‘Buffer Box Signals’’ in Chapters 1 and 2 for more information. 
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Set or Display RQGT Command - 


RQGT = | | 
Examples: 

RQGT 

RQGT = EMU 


CONTINUOUS 


EMULATIONTIME ] 


LATIONTIME 


RQGT = CONTINUOUS 


RQGT 


RQGT = CONTINUOUS 


RQGT 


CONTINUOUS 


~EMULATIONTIME 


A command keyword indicating that the method of handling 
requests for the bus in maximum mode is to be displayed or set. 


The assignment operator. 


Requests for the bus in maximum mode are responded to 
whether or not the ICE-86A emulator is in Emulation mode. 


Requests for the bus in maximum mode are responded to only 
when the ICE-86A emulator is in Emulation mode. 
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Display BUS Command 
BUS 
Examples: 
BUS 
BUS=8086 
BUS A command keyword indicating that the current master of the 
bus is to be displayed. 


+ 
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Memory Mapping Commands 


The commands in this section control ICE-86A memory map. The ICE-86A 
emulator uses the map to identify what user memory is installed and what types and 
sizes of memory are being “‘borrowed’’ from the ICE- 860A emulator for testing © 
purposes. 


This section gives details on the following commands. 


Command Purpose 
MAP DISK Declare which disk file is available for mapping to. 
MAP INTELLEC Declare which physical Intellec segments are available for 


mapping memory to. 


Set MAP Status Assign up to 1024 1K segments of memory locations to USER, 
ICE, INTELLEC, DISK, or GUARDED status. 


Display MAP Status Display status of one or more memory segments. 


RESET MAP Restore the memory map to its initial condition, all 
GUARDED. 
Discussion 


A maximum of 1M byte (megabyte or 1,048,576 bytes) locations are accessible with 
the 20-bit addressing scheme used by the 8086 processor. The MAP commands allow 
this 1M logical address space to be mapped i in 1K-byte segments (on 1K boundaries) 


to any of five locations: (1) physical memory in the user’s system, (2) either of two 


1K-byte segments of ICE-86A ‘“‘real-time’’ memory, (3) a random-access disk file, 
(4) any 1K-byte segment in expansion Intellec memory (addresses at 64K or above), 
or (5) as guarded (i.e., the logical addresses do not physically exist). 


The ICE-86A module supplies 2K bytes of high-speed static memory which may be 
mapped for ‘‘real-time’’ execution. The speed of this memory will allow near real- 
time operation. The 2K bytes may be mapped in 1K-byte segments into appropriate 
address space within the 8086’s 1M-byte address space. 


Disk-based memory and expansion Intellec memory both provide substantially 
slower execution speeds since all accesses to these memories are processed by the 
ICE-86A processor. The first 64K of Intellec memory is reserved for system and 
ICE-86A software. Therefore, any memory assigned to the user must reside in 
expansion Intellec memory above 64K. 


The MAP commands are used to declare, set, display, and reset the ICE-86A 
memory mapping. The ICE-86A emulator has 1M logical addresses divided into 
1024 logical address segments, each starting on a 1K boundary and representing 1K 
bytes of memory. Each segment is addressed by a decimal segment number, n. The 
value of n is an integer value between 0 and 1023. For any given segment n, that seg- 
ment contains addresses nK through nK + 1023. For example, the lowest logical seg- 
ment in memory space contains addresses 0 through 1023 (OK through OK + 1023). 
In a like manner, logical segment 10 would contain addresses 10240 through 11263 
(10K through 10K + 1023). All partitions used in MAP commands must contain seg- 
ment ee whose values lie between 0 and 1023. 
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If the diskette is to be used for user memory, the MAP DISK command must be used 
to declare the disk file to be used. The syntax of the MAP DISK command is: 


MAP DISK = [:drive:] filename 


The command opens the ISIS-II file specified by filename, checks how many 
physical segments will fit on the diskette, and reports this number to you. MAP 
DISK may only be declared initially and once following each RESET MAP 
command. 


If Intellec memory is to be used for user memory, the MAP INTELLEC command 
must be used to specify the physical memory segments in extended Intellec memory 
to be used by user programs. The syntax of the MAP INTELLEC command 1s: 


MAP INTELLEC = partition |, partition )... 


where partition is defined as: 


physical-segment-number (TO physical-segment-number | 
physical-segment-number LENGTH physical-segment-length 


partition -| 


This command declares physical memory segments in expanded Intellec memory 
and checks that the memory physically exists by writing to it and reading back. An 
error occurs if any partitions extend below 64K, as extended Intellec memory exists 
only at addresses 64K or above. Therefore the range of physical-segment-number 
values 1s 64-1023 (inclusive), the range of physical-segment-length values is 1-960 
(inclusive). A warning is issued if the memory does not exist. INTELLEC declara- 
tions are cumulative between RESET MAP commands. Logical memory segments 
may not be set to the Intellec system or disk until the associated MAP INTELLEC 
or MAP DISK commands have been entered. 


NOTE | 


When mapping to Intellec memory on the Model-800 or the Model 22x with 
the 1001194 IPB, the monitor prom circuitry does not decode the four high 
order bits of a 20-bit address. Therefore, addresses of the 20-bit form 
XXXX 1111 XXX XXXKX XXXX (where X is don’t care) will be over- 
shadowed by the monitor and should not be used as addresses to be 
mapped. This does not occur on the Model-225 with the IPC or on the - 
Model-22x with the 1002321 IPB. 


The Set MAP Status command is then used to map logical memory segments to 
physical segments. The syntax of the Set MAP Status command is: 


GUARDED 
USER [NOVERIFY] 
MAP partition =4 ICE [physical-segment-number]| [NOVERIFY] 
INTELLEC [physical-segment-number] [NOVERIFY] 
{ DISK physical-segment-number |NOVERIFY] 


where 


bei eces logical-segment-number [TO logical-segment-number) 
e ~ | logical-segment-number LENGTH /ogical-segment-length 
The Set MAP Status command sets the memory map by assigning logical segments 
to physical addresses in memory: 


USER The logical segments specified are set to exist in the user’s memory 
at the same physical addresses as those specified in the logical 
segments. 
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ICE ~The logical segments specified are set to exist in ICE-86A 
| ‘‘real-time’’ memory. The partition specified may only contain a 
maximum of two segments and the physical-segment-number value 

must be 0 or 1, if one Is given. 


INTELLEC The logical segments specified in the partition are set to exist in 
extended Intellec memory starting in the physical segment specified 
by the physical-segment-number in the command, if one is given. 


DISK The logical segments specified in the partition are set to exist on the 
disk file starting at the physical segment specified by the physical- 
segment-number in the command, if one Is given. 


GUARDED All accesses to memory addresses in the segments specified by the 
input parameter, partition are error conditions. All memory is 
initiallyGUARDED. — 


NOVERIFY Specifies that write-verification will not be performed when using 
the ICE-86A CHANGE command to change the contents of 
memory. This is useful when memory-mapped I/O 1s being used. 
Whenever a logical memory segment is mapped USER, ICE, 
INTELLEC, or DISK, it is  write-verified unless explicitly 
NOVERIFY. 


When mapping to ICE memory, INTELLEC memory, or DISK memory, if a 
physical-segment-number is given in the command, the first logical segment 
specified in the partition is set to the physical segment specified by the physical- 
segment-number and subsequent logical segments are set at subsequent physical 
segments. If more logical segments are specified than physical segments available, 
logical segments will be assigned to available physical segments and an error message 
is displayed indicating that the remaining logical segments are unassigned. If 
physical-segment-number is omitted in the command, the ICE emulator assigns 
from unassigned physical segments in the designated memory. If Intellec or disk 
memory is specified, an error occurs if the resulting physical segment is not one of 
those previously declared by a MAP INTELLEC or MAP DISK command. An 
error also occurs if there are insufficient physical segments unassigned to map the 
specified logical segments. 


~ The Display MAP Status command displays the current setting of the map for the | 


unguarded memory segments specified by partition, if given. If a partition is not 


given, all the unguarded segments for the entire range from 0 to 1023 are displayed. | 


The display is to the following format. The segments are displayed, four segments 
per line, each of the form: 


ical sean = type physical-segment {N] 
where: 

logical-segment = four decimal digits with T suffix 

type =!ICE:: USE:: INT:: DIS 


physical-segment = four decimal digits with T suffix for ICE, INT, DIS and four 
physicalsegment = blanks for USE | 


Example 1. 


MAP0TO3 
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Display: 
0000T = USE 0001T = ICE 0000T 0002T = INT 0064T 0003 = DIS O000T 
Example 2. 


MAP 


Display: 


0000T 
0004T 


USE 0001T =ICE O0000T 0002T =INT 0064T 0003 DIS O0000T 
DIS 0001T 0004T =DIS 0002T 00061 =USE 0007 = USE 


1023T = DIS 


The RESET MAP sets the memory map to its initial condition, all GUARDED, and 
‘‘undeclares’? the DISK and INTELLEC memory available. Multiple logical 
segments may be mapped to the same physical segment. Reassignment of a logical 
segment to a different physical segment causes the physical segment originally 
mapped to become ‘‘guarded,’’ or unused, and reassignable, providing no other 
logical segment is currently mapped to it. 
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MAP DISK Command 
MAP DISK = [:drive: |filename 
Examples: 
MAP DISK = :FO: MYPROG 
MAP DISK = :F1:TEST1 


MAP DIS = TEST2 


MAP A command keyword referring to some operation on the ICE-86A 
map. 


DISK. A command modifier that specifies that an ISIS-II disk file is to be 
opened and available for mapping user memory to. 


‘drive: The diskette drive (:FO:,:F1:,:F2:,or :F3:) that contains the target 
file. If no drive is specified, :FO: (drive 0) is the default. 


filename The name of the desired disk file that is to be opened. The filename 
follows the second colon with no intervening spaces. 


= The assignment operator. © 
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MAP INTELLEC Command 


segmentno |TO segmenino | j segmentno [TO segmentno | ; : 
n]... 


MRE EES | segmentno LENGTH segmentlen} | , segmentno LENGTH segmentle 


Examples: 


MAP INTELLEC = 1023 

MAP INTELLEC = 100 TO 123 

MAP INT = 100 LENGTH 23 

MAP INT = 65, 68 TO 76, 100 LEN 23, 200 TO 250, 260 


MAP A command keyword referring to some operation on the ICE-86A 
map. 

INTELLEC A command modifier specifying Intellec memory. 

segmentno A segment number (64 to 1023) that specifies a physical memory 


segment in Intellec memory. It is used to map Intellec memory in 
one of the following ways: 


e As the address of a single physical segment in Intellec memory. 


e As the address of the first physical segment in Intellec memory 
of a partition of physical segments being mapped. 


e As the address of the last physical segment in Intellec memory 
of a partition of physical segments being mapped. 


TO A connector keyword that denotes that a segment number Is to 
follow that defines the upper bound of a memory partition. 


LENGTH A connector keyword that denotes that a segment length value is to 
follow. 
segmentlen A segment length value (1 to 960) that defines the length of a 


partition of memory. 
= The assignment operator. 


NOTE 


All mapping to Intellec memory is contingent upon the amount of expanded 
Intellec memory a user has in his system. 
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Set MAP Status Command 


MAP logsegmentno [TO logsegmentno | 
| logsegmentno LENGTH segmentien 


Examples: 


GUARDED 
USER [NOVERIFY] 

= 4 ICE [physegmentno | [NOVERIFY] 
INTELLEC [physegmentno] [NOVERIFY] 
DISK [physegmentno] [NOVERIFY] 


MAP 457 = ICE 0 NOVERIFY 
MAP 100 TO 200 = USER 

MAP 201 LEN 62 = INT 65 NOV 
MAP 263 LENGTH 87 = DISK 100 
MAP 351 TO 400 = DIS NOV 
MAP 401 TO 456 = GUARDED 
MAP 458 TO 1023 GUA 


MAP 


logsegmentno 


TO 


LENGTH 


segmentlen 


GUARDED 


USER 
ICE 
INTELLEC 


DISK 


A command keyword referring to some operation on the ICE-86A 
map. 


A logical segment number (0 to 1023) that specifies a segment in 


logical address space. It is used to set the ICE-86A map in one of | 


the following ways: | 
e As the address of a single segment of logical addresses. 


e As the address of the first segment of a partition of logical 
addresses. 3 


e As the address of the last segment of a partition of logical 
addresses. 


A connector keyword that denotes that a logical segment number is 
to follow that defines the upper bound of a partition of logical 


segments. 


A connector keyword that denotes that a logical segment length 
value is to follow defining a partition of logical segments. 


_A segment length (1 to 1024) that defines the length of partition of 


memory. 

The assignment operator 

The initial state of all memory segments. Any reference to a 
guarded address causes an error message. In the emulation mode, 
accesses to a guarded location will cause emulation to terminate 
upon completion of the current instruction. In the interrogation 
mode, no access to the given location will be made. 

Refers to locations in user prototype memory. 

Refers to locations in ICE-86A memory. - 


Refers to locations in Intellec memory. 


Refers to locations in diskette memory. 
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physegmentno A physical segment number (0 to 1023) that specifies a physical 
segment of memory locations. Intellec expanded memory physical 
segment numbers are limited to a range of 1-960. If present in the 
command, the first logical segment in the partition is set equal to 
the value of physegmentno and the subsequent logical segments are 
set equal to the subsequent physical segment number values. If no 
physegmentno is entered, the ICE-86A emulator assigns physical 
— segments from those declared but not yet mapped to. 


NOVERIFY A function keyword that suppresses the normal read-after-write 
verification of data loaded into the designated memory. 
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_ Display MAP Status Command 


MAP. logsegmentno [TO logsegmentno] : 
a | /ogsegmentno LENGTH /ogsegmentien — 


Examples: 


MAP 

MAP 0 TO 100 

MAP 123 LENGTH 200 
MAP 300 LEN 400 


MAP A command keyword referring to some operation on the ICE-86A 
map. | 


logsegmentno A segment number (0 to 1023) that specifies a segment of addresses 
in logical address space. It is used in the following ways: 
e As the address of a single segment of logical addresses. 


e As the address of the first logical segment of a partition of 
logical segments. 


e As the address of the last logical segment of a partition of 
logical segments. 


TO A connector keyword that denotes the following segment number 
defining the upper bound of a partition of logical segments. 


LENGTH A connector keyword that denotes the segment length value 
defining the length of a partition of logical segments. 


logsegmentien A segment length (1 to 1024) that defines the length of a partition 
of memory. 
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RESET MAP Command 
RESET MAP 

Example: 
RESET MAP 


RESET A command keyword that restores its object to its initial state, as 
after an initial ICE-86A invocation. 


MAP As the object of RESET, the token MAP causes the memory map 
to be set to its initial condition, all GUARDED. The available 
DISK and INTELLEC memory is deleted from the map. 
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Set Memory and Port Content Commands 


The commands in this section set new values or change the current content stored in 
designated memory locations or input/output ports. The commands discussed in 
this section are as follows. The purpose of each command is indicated by its title. 


Command 
Set Memory Contents 


Set: Input/Output Port Contents 
Discussion 


Memory Content References 


A memory content reference has the form: 


memory-type address 
| !t!mod-name | !symbol-name ... 


The meta-term memory-type means one of the following ‘content-of’ modifiers for 
memory locations. 


BYTE The content of a single byte (8-bit) memory location. The address 
following BYTE is treated as a logical address; the physical address 
whose content is referenced is determined by look-up in the 
ICE-86A memory map (see Memory and I/O Port Mapping 
Commands). 


WORD The content of two adjacent bytes in memory. The most-significant 
byte is located in the high address of the address pair; the least- 
significant byte is stored in the low address of the pair. The address 
following WORD is treated as a logical address; the ICE-86A 
memory map is consulted to find the physical address whose con- 
tent is referenced. 


SINTEGER The same as BYTE except when displaying. 
INTEGER The same as WORD except when displaying. 


POINTER The content of four adjacent bytes in memory, interpreted as a base 
and displacement. The displacement is located at the low 2 bytes of 
the 4, and the base is at the high 2 bytes. The address following 
POINTER is treated as a logical address; the ICE-86A memory 
map is consulted to find the physical address whose content 1s 
referenced. 


REAL (Also called ‘‘Short Real’’ in some manuals.) The content of four 
adjacent bytes in memory, interpreted as a real number. The 
address following REAL is treated as a logical address; the 
ICE-86A memory map is consulted to find the physical address 
whose content is referenced. The highest bit of the highest byte con- 
tains the sign field. The exponent field stretches from the second- 
highest bit of the highest byte through the highest bit of the second- 
highest byte (eight bits). The remaining twenty-three bits are 
dedicated to storing the significand field. 
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DREAL (Also called ‘‘Long Real’’ in some manuals.) The content of eight 
adjacent bytes in memory, interpreted as a real number. The 
address following DREAL is treated as a logical address; the 
ICE-86A memory map is consulted to find the physical address 
whose content is referenced. The highest bit of the highest byte con- 
tains the sign field. The exponent field stretches from the second- 
highest bit in the highest byte through the fourth-highest bit in the 
second highest byte (eleven bits). The remaining fifty-two bits are 
dedicated to storing the significand field. 


TREAL (Also called ‘‘Temporary Real’’ in some manuals.) The content of 
ten adjacent bytes in memory, interpreted as a real number. The 
address following TREAL is treated as a logical address; the 
ICE-86A memory map 1s consulted to find the physical address 
whose content is referenced. The highest bit of the highest- 
addressed byte contains the sign field. The exponent field stretches 
from the second-highest bit of the highest byte to the lowest bit of 
the second-highest byte (fifteen bits). The remaining sixty-four bits | 
are dedicated to storing the significand field. 


Real numbers (type REAL, DREAL, or TREAL) are stored in three ‘‘fields’’: the 
number’s significant digits are held in the significand field, the exponent field 
locates the binary point within the significant digits, and the sign field indicates 
whether the number is positive or negative. The most significant digits of each field 
are stored in the highest addresses. See figure 7-1 for the format of these types in 
memory. | 


See The 8086 Family User’s Manual Numerics Supplement, Manual Order Number: 
121586, for further details on the storage of real values. 


The meta-term address means one of the following types of entries. 
numeric-expression The forms for numeric expressions are presented in Chap- 


ter 5. The result obtained when the expression is evaluated 
becomes an address modulo 64K. 


(mem-type address) A memory content reference with a form such as BYTE 
(WORD 1000) represents an indirect reference. The content 
of the address or address-pair inside the parentheses 1s treated 
as the address for the mem-type outside the parentheses. 


To obtain the content of bytes, words, or pointers in a range of addresses, use the 
form: 


memory-type partition 
A partition can be a single address or one of the following types of constructs: 
address TO address 
address LENGTH number-of-bytes (for BYTE and SINTEGER) 
address LENGTH number-of-words (for WORD and INTEGER) 
address LENGTH number-of-double-words (for POINTER) 


¢ 


The first form of partition uses the keyword TO. The address on the right of the 
keyword TO must be greater than or equal to the one on the left. With BYTE and 
SINTEGER, this form allows you to access the content of each byte location in the 
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S: Sign bit 
MSE/LSE: Most/least significant exponent bit 
MSS/LSS: Most/least significant significand bit 


Figure 7-1. REAL, DREAL and TREAL Memory Types 162554-8 


range; the range includes both the first and last address in the partition. With 
WORD or INTEGER, the first address is treated as the low address of the first 
address pair in the range; subsequent pairs of addresses are accessed until the second 
address is reached. If the second address is the low address of a pair, the word 
formed from the content of that address and the next consecutive higher address is 
accessed; if the second address is not the low address of a pair (that is, if it turns out 
to be the high address of a pair already accessed in the range), the access ends after 
the last complete pair has been accessed. Word-length accesses can begin on either 
an even-numbered or an odd-numbered address. With POINTER, the first address 
is treated as the low address of the first address quadruple in the range; subsequent 
quadruples of addresses are accessed until the second address is reached. If the 
second address is thedow address of a quadruple, the pointer formed from the con- 
tent of that address and the next three consecutive higher addresses is accessed; if the 


second address is not the low address of the quadruple, the access ends after the last 


quadruple has been accessed. Pointer-length accesses can begin on either an even- 
numbered or an odd-numbered access. | 
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The second, third and fourth forms use the keyword LENGTH. The address 
preceding the keyword LENGTH is the starting address in the range, as with the first 
form (using TO). The number or expression following the keyword LENGTH gives 
the number of addresses (when the controlling memory-type is BYTE or 
SINTEGER), the number of address pairs (for WORD or INTEGER), or the 
number of addresses quadruples (for POINTER). (Must be an integer value.) 


Setting Memory Contents 
To assign a new content to a byte, sinteger, word, integer, pointer or real location, 
use a command with the form: 

mem-type address = new-content 

['"Wmod-name | !symbol-name... 


The meta-terms mem-type and address represent the types of entries discussed 
earlier in this section. 


The meta-term new-content represents one of the following types of entries (for 
single addresses, setting the content of a range of addresses will be discussed later 
On). : 


numeric-expression A numeric expression evaluated by the ICE-86A emulator to 
a single number. 


If mem-type isa POINTER, new-content must be a pointer value. Otherwise, new- 
content must be an integer value. 


When a single byte address is to be set, the ICE-86A emulator treats the new-content 
as an 8-bit quantity. If mew-content has more than eight bits, the least-significant 
eight bits in the quantity are used as the new content, and the other (higher) bits are 
lost. If new-content has fewer than eight bits, the bit values in the quantity are right- 
justified (placed in the low-order bits in the address), and the remaining (high) bits in 
the location are set to zeroes. 


Here are some examples of setting byte contents. The first line of each example 
shows the command that sets the new contents; the second line gives a command 
that produces a display of the contents just set; the third line shows the resulting 
display. The output radix is assumed to be H (hexadecimal). 


*BYTE 1000H = FFH (or)* BYTE 0100:0000 = FFH 
*BYTE 1000H *BYTE 0100:0000 

BYT 0000:1000H=FFH BYT 0100:0000H=FFH 
*BYTE 1010H = RAL + 1 (or)*BYT 100:10H = RAL + 1 
*BYTE 1010H *BYT 100:10H 

BYT 0000:1010H=F1H | BYT 0100:0010H=F1H 
*BYTE 1020H = FFI1H (or)* BYTE 100:20 = FFI1H 
*BYTE 1020H *BYTE 100:20 

BYT 0000:1020H=11H BYT 0100:0020H=11H 
*BYTE 1030H =1Y (or)*BYT 103:0 = 1Y 
*BYTE 1030H *BYT 103:0H | 
BYT 0000:1030H=01H 7 BYT 0103:0000H=01H 
*BYTE 1040H = ‘A’ (or)*BYT 104:0 = ‘A’ 
*BYTE 1040H *BYT 100:40 | 

BYT 0000:1040H=41H | BYT 0100:0040H=41H 
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*BYTE 1050H = BYTE 1000H | (or)*BYTE 100:50H = BYT 100:0H 


*BYTE 1050H *BYT 105:0 


. BYT 0000:1050H=FFH ; BYT 0100:0050=FFH 


You can change the radix used to display the contents using the Set Output Radix 


(BASE) command. 


When a single word address is to be set, the ICE-86A emulator treats the new- 
content as a pair of bytes. The least-significant byte is loaded into the low address in 
the pair, and the most-significant byte is loaded into the high address in the pair. If 
new-content has fewer than 16 bits, the bit values are loaded starting with the low 
address and right-justified. The remaining (high) bits in the address pair are set to 
zeroes. The following examples demonstrate some of the possibilities for the setting 
address pairs: 


*WORD 1000H = 1122H (or)*WORD 0:1000H = 1122H 
*“WORD 1000H *WOR 0:1000H 
WOR 0000:1000H=1122H | WOR 0000:1000H=1122H 
*WORD 1010H = FFH (or)* WOR 101:0H =FFH 
*“WORD 1010H | ; *WORD 101:0 
WOR 0000:1010H=00FFH WOR 0101:0000H=00FFH 
*WORD 1030H = WORD 1000H (or)*WORD 0:1030H = WOR 0:1000H 
*WORD 1030H *WOR 103:0 


WOR 0000:1030H=1122H | WOR 0103:0000H=1122H 


When a single pointer is to be set, the ICE-86A emulator treats the new-content as a 
displacement and base. The least-significant byte is loaded into the low address in 
the quadruple, and most-significant byte is loaded into the high address. The follow- 
ing examples demonstrate some of the possibilities for setting pointers: 


*POINTER 1000H = 1122:3344H (or)* POI 100:0 = 1122:3344H 
*POINTER 10000H *POI0:1000H 
POI! 0000:1000H=1122:3344H POI 0000:1000H=1122:3344H 


Assume that X and Y refer to any symbol name. A command of the form BYTE X = 
BYTE Y copies the content of the address Y to the content’of address X where 
addresses X and Y are either integer or pointer values as shown in the examples 
above. A command of the form WORD X = WORD Y copies the content of address 
Y to location X, and the content of address (Y+1) to location (X+1). A command of 
the form POINTER X = POINTER Y copies the content of location Y through 
(Y+3) to locations X through (X+3) respectively. A command of the form BYTE X 
= WORD Y copies the content of address Y to location X; the content of location 
(X!1) is unchanged. A command of the form WORD X = BYTE Y copies the con- 


tent of address Y to location X; the content of location (X+1) is set to a byte of 


zeroes. POINTER X = BYTE Y copies (Y) to (X) zeroes in (X) + 1 to (X) + 3. 


This also works for REALs of the same type. A command of the form DREAL X = 
DREAL Y copies the content of the address Y to the content of address X. 


The commands used to set a range of addresses differ in some details. 
One way to set a range of addresses is with the command of the form: 


mem-type address =list of new-content values 


With this form the address on the left side of the equals sign gives the starting loca- | 


tion, and the number of values in the list to the right of the equals sign tells the 
ICE-86A emulator how many consecutive addresses to load. Consecutive locations 
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are changed to the values of the new-contents in left-to-right order. The list of new 
content values can consist of expressions, multi-character strings, and memory 
partitions. 


Here are some examples showing the use of this form of the set memory contents 
command. 


*BYTE 1000H = 11H, 22H, 33H, 44H, 55H, 66H, ‘AB’ 
*BYT 1000H LEN 8T 
BYT 0000:1000H=11H 22H 33H 44H 55H 66H 41H 42H 


*WOR 200:0H = FFFFH, WORD 100:0H 
*WOR 200:0H LENGTH 2T 
WOR 0200:0000H=FFFFH 2211H 


*PO! 4000:20H = 1122:3344H, WOR 1002H, BYT 1002 
*POI! 4000:20H LEN 3T 
PO! 4000:0020H=1122:3344 0000:4433 0000:0033 


“REAL 100H = -9.9, 44.3E12 
*REAL 100 LEN 2 
REAL 0000:0100H = -9.89999962E+0 + 4.42999998E +13 


*TRE 2000 = 1.0, 2.0, 3.0, 4.1E-5 

*TRE 2000 LEN 4 

TRE 0000:2000H= + 1 .00000000000000000E + 0 + 2.0000000000000000000E + 0 
TRE 0000-201 4H= + 3.00000000000000000E +0 + 4.1000000000000000000E— 5 


To set a range of addresses all to the same new value, use a command of the form: 


mem-type partition = new-content 


The forms of partition are discussed above in this section. All addresses in the parti- 
tion are set to the single new-content value. The following examples show some of 
the possible results obtained with this command form: 


*BYT 1000H TO 1004H =FFH 
*BYTE 1000H LEN 5H 
BYT 0000:1000H=FFH FFH FFH FFH FFH 


*WORD 200:0 LENGTH 6T = AAO0OH 
*WOR 200:0H TO 200AH 
WOR 0200:0000H=AA00H AAO0H AAO0H AAOOH AAOOH AAODOH 


*POINTER 3000H LEN 3T = 1234:5678H 
POI! 0:3000H TO 0:300BH 
WOR 0000:3000H=1234:5678 1234:5678 1234:5678 


*REA 2000 LEN 8 = 1.0, 2.0 

*REA 2000 LEN 8 

REA 0000:2000H=+1.00000000E+0  +2.00000000E +0 
REA 0000:2008H=+1.00000000E+0  +2.00000000E +0 
REA 0000:2010H= + 1.00000000E +0 + 2.00000000E + 0 
REA 0000:2018H=+1.00000000E+0  +2.00000000E +0 


*DRE 2000 LEN 4=1.0E-10 

*DRE 2000 LEN 4 

DRE 0000:2000H= + 1.0000000000000000E-10 + 1.0000000000000000E-10 
DRE 0000:2010H= + 1.0000000000000000E-10 + 1.0000000000000000E-10 
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The last form of the set memory contents command sets the contents of each address 
in a range (partition) to the corresponding new-content in a list of values. This form 
is as follows: 7 


mem-type partition =list of new-content values 


This form combines the two forms discussed above. The list of new-content values 
can consist of expressions, multi-character strings and memory partitions. 


If the number of locations in the partition is equal to the number of values in the 
new-content list, the addressed locations are set to the corresponding values in the 
list, in left-to-right order. 


If the number of locations in the range is greater than the number of new values in 
the list, the locations are filled with the values from left-to-right, repeating the 
values in left-to-right order as necessary to fill all the locations. The maximum 
number of bytes that can be repeated is 128. With more than 128 bytes, the data is 
transferred but not repeated, and an error message is displayed. 


If the number of new values in the list is greater than the number of locations in the 
partition, the lowest location receives the first value, and successive locations in the 
range receive values in left-to-right order until all locations in the range have 
received values. The excess values are then detected by the ICE-86A emulator as an 
error condition, and an error message is displayed. The excess values are lost. 


Here are a few examples showing this form of command: 


*BYT 1000H TO 1004H = ‘ABCDE’ 
*BYT 1000H LEN 5T 
BYT 0000:1000H=41H 42H 43H 44H 45H 


*WORD 200:0H LENGTH 6T = 1122H, ‘AB’. 
*WOR 200:0H TO 200:AH 
WOR 0220:0000H=1122H 0041H 0042H 1122H 0041H 0042H 


*BYTE 1000H TO 1002H = 11H, 22H, 33H, FFH 
ERR 97:EXCESSIVE DATA 

*BYT 100:0 LEN 4T 

BYT 1000:0000=11H 22H 33H 44H 


In the third example, note that the byte at location 1003H retains the value set in the 
first example in the group of examples (44H rather than the FFH given in the 
command.) 


Port Content References 


The set port contents commands parallel those of the set memory contents com- 
mands with the exception of port addressing. There are a total of 65536 8-bit ports 
available for input/output in the ICE-86A emulator. The ports are referenced by the 
mnemonic PORT. These ports can be referenced as 16-bit ports by the mnemonic 
WPORT. Each port is referenced by a port-number that i is an integer value in the 


Tange of 0 through 65535. 


To assign a new content to an as bit or 16-bit port, use the following command with 
the form: 


port-type port-number = new-content — 
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The meta-terms port-type and port-number are used to specify individual ports. 
port-type Defines the port type and size: 
PORT An 8-bit port. 
WPORT A 16-bit port. - 
port-number An integer value specifying a specific port. 
The following are examples of the use of this command form: 
PORT 123 = FFH 
WPORT 123 = FFFFH 
One way of setting a range of ports is with the command of the form: 
port-type port-number =list of new-content values 
With this form the port-number on the left side of the equals sign gives the starting 
port location, and the list to the right of the equals sign tells the ICE-86A emulator 
how many consecutive ports to load. Consecutive ports are changed to the values of 
the new-contents in left-to-right order. 
Here are some examples showing the use of this form: 
PORT 1000H = 11, 22, 33H, 44H, 55H, 66H 
WPORT 1000H = 1122H, 3344H, 5566H 
To set a range of ports all to the same new value, use a command of the form: 
port-type partition = new-content 
The following are seamalee of this form: 
PORT 1000H TO 1005 = FFH 


WPORT 2000H LENGTH 20H = FFFFH 


The last form of the set port contents sets the contents of each port in a range (parti- 
tion) to the corresponding new-content in a list of values. This form is as follows: 


port-type partition = list of new-content values 


If the number of ports in the partition is equal to the number of values in the new- 
content list, the addressed ports are set to the corresponding values in the list, in left- 
to-right order. 7 


If the number of ports in the range is greater than the number of new values in the 
list, the ports are filled with the new values from left-to-right, repeating the values in 
left-to-right order as necessary to fill all the ports. 


If the number of new values in the list is greater than the number of ports in the par- 
tition, the lowest numbered port receives the first value, and successive ports in the 
range receive values in left-to-right order until all ports in the range have received 
values. The excess values are then detected by the ICE-86A emulator as an error con- 
dition, and an error message 1s displayed. The excess values are lost. 
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‘Here are a few examples showing this form of command: 
PORT 1000 TO 1005H = ‘ABCDE’ 
WPORT 2000H LEN 6T = 1122H, ‘AB’ 


PORT 1000H TO 1002H = 11H, 22H, 33H, FFH | 
(an error message such as EXCESS VALUES is displayed) 


NOTE 


Byte, Word, and Port commands respond with DONE timeouts if 
RWTIMEOUT = INFINITE and no user ready occurs for 15 seconds. 
However, the 8086 is still active on the user bus until the RESET HARD- 
WARE command is entered. 
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mem-type partition=new-content|, new-content] ... 
typed-mem-ref = numeric-expression 


Examples: 


BYTE 0800H = FFH 

BYTE 7000H LENGTH 16T = 00H . 
BYT 0800 TO 0805 = 12H, 34H, 56H, 78H, 9AH, BCH 
WORD 70FFH = IP 

WOR 7000H = PIP +1 

POINTER 8000H = ABCD:1234H 

BYTE 0800H = ‘ABCDE’ 

POI 7000H = POI 4000H LEN 20H 

BYT #56 = FAH 


IVAR = 75 
IX=!X +1 


IIMODA !PTR =SS:SP 
REA 1000H = -12345.6789E-5 


mem-type 


partition 


new-content 


typed-mem-ref 


Interrogation and Utility Commands 


One of the nine memory ‘content-of’ modifiers BYTE, WORD, 
SINTEGER, INTEGER, POINTER, REAL, DREAL, or TREAL. 


One or more contiguous locations in memory. 


One of the following types of entries, to be used as the new contents 


of the memory location: 
numeric-expression 
‘string’ 

mem-type partition 
port-type partition 


See Typed Memory Reference in Chapter 5. 
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Set Input/Output Port Contents Command 
port-type partition = new-content |, new-content]... 
~Examples: 


PORT 0800H =FFH 

PORT 7000H LENGTH 16T = 00H 

POR 0880 TO 0885 = 12H, 34H, 56H, 78H, 9A, BCH 
WPORT 70FFH = IP _* 
WPO 7000H = PIP + 1 

PORT 0800H = ‘ABCDE’ 

PORT #56 = FAH 


port-type One of the two port ‘content-of’ modifiers PORT or WPORT. 

partition One or more contiguous ports (must be integers). 

new-content One of the following types of entries, to be used as the new contents 
of the port: 7 


numeric-expression 
‘string’ 

mem-type partition 
port-type partition 
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Symbol Table and Statement Number 
Table Commands | 


The ICE-86A emulator maintains a symbol table and source program statement 
number table to allow you to refer to memory addresses and other values by using 
symbolic references and statement references in the ICE-86A commands. 


This section gives details on the following commands: 


Command 


DEFINE Symbol 

Display Symbols 

Display Statement Numbers 
Display Modules 

Change Symbol 

REMOVE Symbols 
REMOVE Module 

TYPE 

Set DOMAIN 

RESET DOMAIN 

ENABLE/ DISABLE Symbolic Display 


Discussion 


The ICE-86A symbol table receives symbols from two sources; the symbol table 
associated with the user program can be copied to the ICE-86A symbol table when 
the program is loaded, and the user can define additional symbols for use during the 
emulation session. 


Corresponding to each symbol in the table is a number that you can interpret and 
use either as an address or as a numeric value (variable or constant). The next few 
paragraphs discuss the kinds of symbols that can appear in the table, and the inter- 
pretation of the corresponding symbol table quantity (address or value). 


Instruction and statement labels are loaded with the program code. The symbol 
table gives the address of the instruction corresponding to the label. 


A program variable is a symbol for a quantity that can have its value changed as a 
result of an instruction in the program. Program variables are LOADed with the 
program code. The symbol table gives the address where the variable value is stored. 


A program constant is a symbol for a label set to a constant value (for example, 
using the assembler directive EQU or SET). Program constants are loaded into the 
symbol table when the program code is loaded. The symbol table gives the constant 
value associated with the symbol. 


A module name is the label of a simple DO block that is not nested in any other 


block (for PL/M-86), or a label that is the object of a NAME directive (in 8086 


assembly language). If no NAME directive is given, the module name is the same as 
the source file name without the extension. For example, if the source file name is 
“:FI:MYPROG.A86’’, the module name will be ““MYPROG’’. 


A module name itself does not have a corresponding address value in the symbol 
table. However, symbols contained in a module are considered to be ‘local’ to that 
module; the ICE-86A emulator thus allows you to reference multiple occurrences of 
the same symbol name in different modules, by using the module name as a modifier 


in the symbolic reference. 
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The ICE-86A symbol table is organized to preserve the modular structure present in 
the program. Initially (before any code is loaded), the symbol table consists of one 
‘unnamed’ module. Any symbols defined without a specific module name are stored 
in the unnamed module in the order they were defined. The unnamed module is 
always the first module in the symbol table. Following the unnamed module, named 
modules are stored in the symbol table in the order that the modules were loaded 
into the ICE-86A emulator. Symbols local to each named module are stored in the 
order they appear in the module. 


In addition to the symbols stored when the program code is loaded, you can use the 
DEFINE Symbol command to define new symbols for your use during the emula- 
tion session. The rules for user-defined symbols are as follows. 


The name of the new symbol (symbol-name ) can be defined with a maximum of 122 
characters. However, the ICE-86A emulator truncates each symbol-name to the first 
31 characters. Thus, to be different, two symbols must be unique in the first 31 
characters. 


The first character in the new symbol-name must be an alphabetic character, or one 
of the two characters @, underscore (__), dollar sign ($), or ?. The remaining 
characters after the first can be these characters or numeric digits. 


You can specify the module that is to contain the new symbol you define. Symbols — 


defined without a module are placed in the unnamed module at the head of the 


table, in the order they were defined. Symbols defined with an existing module name © 


are placed in that module’s section of the table; the module named must already 
exist in the table. 


The new symbol name cannot duplicate a symbol name already present in the 
module specified. You can, however, have two or more symbols of the same name in 
different modules. 

When you define a new symbol, you also specify the value corresponding to it in the 
table. You can treat the value you assign as an address or as a numeric value for use 
other than addressing. 

The DEFINE Symbol command has the following form: 


DEFINE s ymbolic-reference = address. value [OF memory-type | 


The forms of symbolic-reference are shown in table 7-8. The meaning of each form 


is as follows. Not all forms can be used ina DEFINE Symbol command. 


A simple symbolic-reference has the form .symbol-name. The ICE-86A emulator 


searches for this form of reference starting with the first symbol in the unnamed 


module. If the symbol is not in the unnamed module, the ICE-86A emulator 
searches through the named modules in the order they were loaded, and takes the 
first occurrence of the symbol in the first (earliest) module that contains it. 


When you define a symbol without a module, it is placed in the unnamed module. 


The symbolic-reference can include a module-reference. The module reference 
immediately precedes the symbol name; the module-name is identified by a prefix 


consisting of a double period (..). When you define a symbol with a module 
reference, the symbol is added to the symbols under that module. A later reference 


to a symbol with a module name restricts the search to that module. 


The meta-term address/value as used in the DEFINE Symbol command means one 
of. the forms of numeric expressions given in Chapter 4. 
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Table 7-8. Symbolic References and Statement References 
ize, | weeaton | came | on] ore | crn | nove 
Reference 
YES YES YES YES 


Symbolic .symbol-name .ABC 
YES, if module is already present in table. 


Symbolic ..module.symbol-name ..MAIN.D EF 


XX.YY 


Symbolic .symbol-name.symbol-name 


#56 


Statement | #statement-number 


._MAIN#4 4 


Statement . Module#stmt-number 


The meta-term memory-type is one of the following memory types: BYTE, WORD, 
SINTEGER, INTEGER, POINTER, REAL, DREAL, or TREAL. 


Once a symbol has been defined or loaded, any reference to that symbol is 
equivalent to supplying its corresponding address or value. 


To display the value from the symbol table corresponding to any symbol, enter the 
appropriate symbolic reference followed by a carriage return. The ICE-86A 
emulator displays the symbol table value on the next line. 


To display the entire ICE-86A symbol table, enter the command SYMBOL followed 
by a carriage return. Symbols are displayed module by module, starting with the 
unnamed module. The address/value corresponding to each symbol is also 


displayed. 
Example 1: 
* SAM (command) 
.SAM=0200:1FE2H OF INT (display) 
Example 2: 
*..MYPROG .SAM (command) 
.SAM=0200:1FE2H OF INT (display) 
Example 3: 
*SYMBOL (command) 
. TEMP=0000:0001H (display) 


MODULE ..MAIN 
.BEGIN= 0800:0050H 
.VAR=0800:0100H OF BYT 
MODULE ..SUBR 
.PROC=0800:0069H 
.X=0800:0101H OF WOR 


The ICE-86A emulator also maintains a statement number table for user programs 
written in PL/M-86 source code. The statement numbers are assigned by the 
PL/M-86 compiler. Corresponding to each source statement number in the table is 
the address of the first instruction generated by that source statement. 


Table 7-8 shows the forms used to refer to statement number in the ICE-86A 
emulator. The simplest form is the statement-number prefixed by a number sign (#). 
A module-reference can precede the statement reference, since the statement 
number table preserves any modular structure in the program. Thus, two modules 
compiled separately can have the same statement numbers; the module reference 
tells the ICE-86A emulator which statement number to use. 
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To display the address corresponding to a statement-number, enter the appropriate 
statement number reference followed bya calles return. 


The ICE-86A emulator does not allow you to change the address corresponding to 


any existing statement number, to define any new statement numbers, or to delete 
(REMOVE) any statement numbers. 


To display the value from the statement number table of any statement number, 
enter the appropriate statement number reference followed by a carriage return. The 
ICE-86A emulator displays the statement number value on the next line. 


Example I: 
“#1 (command) 
#1=0800:0050H (display) 
Example 2: 
* MAIN#2 (command) 
#2=0800:0057H (display) 


To display the addresses of all the statement numbers in the statement number table, 
enter the keyword LINE. The ICE-86A emulator displays all the statement number 
addresses starting on the line following the command. 


Example: 
*LINE (command) 
MODULE ..MAIN. (display) 


#1=0800:0050H 
#2=0080:0057H 
MODULE ..SUBR 
#1=1140:0012H 
#2=1140:0037H 
#3=1140:00DFH 


To display the names of all the modules currently in the ICE-86A module table, 
enter the keyword MODULE. The ICE- 86A emulator displays the names of all the 
modules currently in the table. 


Example: 


*MODULE | (command) 
MODULE ..MAIN (display) 


MODULE .-SUBR 


You can change the address/value corresponding to an existing symbol by entering a 
command of the form: 


symbolic-reference=address::value [OF memory-type | 


Any of the three forms of symbolic- reference shown in table 7-7 can be used to iden- 


tify the symbol whose value is to be nee The symbol must already exist as 


referenced. 


The forms of address: ‘value are discussed earlier in this section. Any of these forms 
may be used to change the value of an existing symbol. 
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Where multiple occurrences of the same symbol name exist in the table, the rules for 
table search given earlier determine which or the several instances of the symbol is to 
receive the new address value. 
To delete one or more symbols from the table, use a command of the form: 

REMOVE list of symbolic-references 
The symbolic-references in the list are separated by commas. The ICE-86A emulator 
searches the table for each reference using the search rules given earlier, deleting the 


first occurrence of each symbol name that fits the type of reference given. 


Note that deleting a symbol from the ICE-86A symbol table makes that symbol 
inaccessible to the ICE-86A emulator but does not affect the program code. 


To delete the entire ICE-86A symbol table and the statement number table, enter the 
command REMOVE SYMBOL. 


To delete one or more modules, enter the following command: 
REMOVE MODULE module-name |, module-name }... 


Removing a module removes all symbols and statement numbers in the module, but 
does not affect object code. 


Example 1: 

REMOVE MODULE ..MAIN 
Example 2: 

REM MOD ..MAIN, ..SUBR 


The TYPE command allows you to assign or change the memory type of any symbol 
in the symbol table. The TYPE command is entered in the following format: 


TYPE symbolic-reference =memory-type 
The referenced symbol is assigned the memory type entered in the command. 
Example: 

TYPE ..MYPROG .SAM = WORD 
The symbol .SAM now is memory type WORD. 
The Set DOMAIN command establishes a specified module as the default module 
for statement numbers. The RESET DOMAIN command establishes the first 
module in the module table after the unnamed module as the default for statement 


numbers, if there is a module other than the unnamed module; otherwise it 
establishes the unnamed module as the default. This is the initial domain. 


Setting the domain should be especially useful for avoiding having to use module 


names on statement numbers from a particular module while debugging that portion 
of the program. 


When symbolic display is enabled, the ICE-86A emulator attempts to display values 
in pointer format in terms of symbols stored in the symbol table and statement 
numbers stored in the statement number table. Given an address b-d to represent, 
the ICE-86A emulator linearly searches first the symbol table and then the statement 
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number table for symbols or statement numbers associated with base b and the 
largest displacement less than or equal to d. If more than one such symbol or state- 
ment number is found, then the ICE-86A emulator displays the first located item. 


The display is in the form: 


module-name} symbol + remainder (if greater than 0) 
#decimal-10 


where remainder is the number of bytes difference between d and the displacement 


associated with the symbol or statement number. 


In the case of a memory display, only if an exact address match is found (remainder 
= (0) is the symbolic information displayed. The display occurs on the line immedi- 
ately preceding the normal address reference. | 


Example: 


*“BYTE 100 = 05H 

*DEF .Z = 100H OF WORD 
*BYTE 100 

“lL 

BY T 0000:0100H=05H 


In the case of a register display, an exact address match is not necessary (i.e., 
remainder does not have to equal 0). The symbolic information Is displayed instead 
of the address. 


Example: 


-*DEF .Z = 100H OF POI 

*GO 

EMULATION BEGUN <esc> 

EMULATION TERMINATED, CS:IP=.Z +053DH 


Observe that the symbolic display is not affected by whether or not the symbol! or 
memory reference is of type pointer; symbolic display occurs whenever a value is to 
be displayed in pointer format. If no symbol or statement number can be found that 
has associated with it an address with base equal to b, then normal display occurs. 


Symbolic display is initially disabled. To enable symbolic display, type ENABLE 
SYMBOLICALLY. To disable symbolic display again, type DISABLE 
SYMBOLICALLY. | 
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DEFINE Symbol Command 


DEFINE [module-name | symbol = expression [OF memory-type | 
Examples: 


DEFINE ..MAIN .BEGIN = F3H OF BYTE 
DEF .CAR = 0000:0F00H 

DEF .VAR = 123T OF WOR 

DEF .ENT1 = .VAR + 10 OF WOR 

DEF .CAT2 = 0700:0050H OF POI 

DEF ..SUBRA .CAT2 = 0000:00FOH OF POI 
DEF .RE = 0001T OF REAL 


DEFINE A command keyword that tells the ICE-86A emulator to enter the 
new symbol in the appropriate module table, and assign the symbol 
the initial value given. 


module-name A sequence of contiguous alphanumeric characters, prefixed by a 
pair of periods (..) that references a program module. 


symbol A sequence of contiguous alphanumeric characters, prefixed by a 
period (.) that references a location in a symbol table. 


= The assignment operator. 
expression A numeric expression. 


OF A command modifier keyword denoting that a specification of 
memory type is to follow. 


memory-type -A specification of the memory type of the symbol: BYTE, WORD, 
SINTEGER, INTEGER, POINTER, REAL, DREAL, or TREAL. 
If omitted, symbol has no type. 
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Display Symbols Command 
SYMBOL — 

[module-name ] symbol [symbol ]... 
Examples: 


SYMBOL 
-TEMP=0000:0001H 
MODULE ..MAIN 
.BEGIN=0800:0050H 
.VAR=0800:0100H OF BYT 
MODULE ..SUBR 
-PROG=0800:0069H 
.X=0800:0101H OF WOR 


SYMBOL A command keyword that tells the ICE-86A emulator to display 
the entire ICE-86A symbol table, module by module. 


module-name — A sequence of continuous alphanumeric characters, prefixed by a 
pair of periods (..) that reference a program module. 


symbol A sequence of contiguous alphanumeric characters, prefixed by a 


period (.) that references a location in a symbol table. 


7-52 


ICE-86A 


ICE-86A 


Interrogation and Utility Commands 


Display Statement Numbers Command 


LINE 


[module-name | #decimal-10 


Examples: 
LINE 
#54 
. . MAIN#44 


LINE 


module-name 


# 


decimal-10 


A command keyword that tells the ICE-86A emulator to display all 
statement numbers and associated absolute addresses in the current 
domain. 


A sequence of contiguous alphanumeric characters, prefixed by a 
pair of periods (..) that reference a program module. 


The ‘number’ sign designating the reference as a statement number. 


The (source) statement number (a numeric constant). The default 
suffix is always decimal. 
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Display Modules Command 


MODULE 
Example: 
MODULE 
MODULE A command keyword that tells the ICE-86A emulator to display 
ie oe of all the modules currently in the ICE-86A module 
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Change Symbol Command 

[module-name | symbol [symbol }... = expression |OF memory-type | 
Examples: 

.ABC = 2000H 

..MAIN.DEF = AAFFH OF WOR 


..SUBR.PARM = .ABC + 10 
.TEMP = .ABC + ..MAIN.DEF OF WORD 
.R = 1001 H OF REAL 


module-name 


symbol 


expression 


OF 


memory-type 


A sequence of contiguous alphanumeric characters, prefixed by a 
pair of periods (..) that references a program module. 


A sequence of alphanumeric characters, prefixed by a period (.) 
that references a location in the symbol table. 


The assignment operator. 
A numeric expression. 


A command modifier keyword denoting that a specification of 
memory type is to follow. 


A specification of the memory type of the changed symbol: BYTE, 
WORD, SINTEGER, INTEGER, POINTER, REAL, DREAL, or 
TREAL. If omitted, do not change symbol’s type. 
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REMOVE Symbols Command 


REMOVE [module-name] symbol [symbo/!]...[, [module-name]| symbol [symbof]...]... 


REMOVE SYMBOL 


REMOVE MODULE module-name [,module-name |]... 


Examples: 


REMOVE .ABC 

REMOVE ..MAIN.DEF 

REMOVE .HlJ,.PARM1, ..MAIN.TWO,.CARS,.CARS1..SUBR.XX 
REMOVE SYMBOL | 

REMOVE MODULE ..MAIN,..SUBR,..CALC 


REMOVE 


module-name 


symbol 


SYMBOL 


MODULE 


A command keyword causing the symbols that follow to be deleted 
from the ICE-86A symbol table. 


A sequence of alphanumeric characters, prefixed by a pair of © 


periods (..) that references a program module. 


A sequence of alphanumeric characters, prefixed by a period (.) 
that references a location in the symbol table. 


A command modifier that tells the ICE-86A emails! to delete the 
entire current ICE-86A symbol table. 


A command modifier that tells the ICE-86A emulator to delete all 
the symbols and lines of the named module from the ICE-86A 
tables but does not affect object code. | 
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TYPE Command 


TYPE [module-name | symbol |symbol!]... = memory-type 
Examples: 

TYPE .ABC = POINTER 

TYPE ..MAIN.DEF = WOR 

TYPE ..SUBR.PARM,.XX,.YY = BYT 

TYPE .R=REAL - 


TYPE A command keyword that allows the user to assign or change the 
memory type of any symbol in the symbol table. 


module-name A sequence of alphanumeric characters, prefixed by a pair of 
periods (..) that references a program module. 


symbol A sequence of alphanumeric characters prefixed by a period (.) that 
references a location in the symbol table. 


= The assignment operator. 
memory-type A specification of the memory type to be assigned to the referenced 


symbol: BYTE, WORD, SINTEGER, INTEGER, POINTER, 
REAL, DREAL, or TREAL. 
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Set DOMAIN Command 


DOMAIN module-name 


Example: 
DOMAIN ..MAIN 
DOMAIN A command keyword that causes the ICE-86A emulator to 


establish the named module as the default module for statement 
numbers. 


module-name A sequence of alphanumeric characters prefixed by a pair of 
periods (..) that references a program module. 
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RESET DOMAIN Command 
RESET DOMAIN 
Example: 
RESET DOMAIN 
RESET A command keyword restoring its object to a reset condition. 
DOMAIN A modifier keyword that causes the ICE-86A emulator to establish 
the first module after the unnamed module as the default module 


for statement numbers. If there are no named modules, the 
unnamed module is established as the default module. 
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ENABLE/DISABLE SYMBOLICALLY Command 


one ! SYMBOLICALLY 


| DISABLE 
Examples: 
ENABLE SYMBOLICALLY 
DISABLE SYMBOLICALLY 
ENABLE A command keyword that causes symbolic display to be enabled. 
DISABLE A command keyword that causes symbolic display to be disabled. 


SYMBOLICALLY Command modifier denoting that symbolic display is to be 
enabled/disabled. 
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Display Commands 


This section presents the ICE-86A commands that allow you to reference and 
display the following systems elements: 


8086 Processor Registers 
ICE-86A Status Registers 
8086 Pin Signals 

Memory 

Ports 

Status Flags 


RQGT and Bus Status 


The following commands are discussed in this section: 


Command Purpose 

Display Processor and Display the current contents of any of the 8086 

Status Registers processor registers and ICE-86A status registers. 

Display CAUSE Display strings representing the state of the CAUSE 
register. 

Display Memory Display the contents of a range of memory. 

Display 1/O Display the contents of a range of |/O locations. 

Display STACK Display the contents of the user’s stack. 

Display Boolean Display boolean values. 

Display NESTING Display the start and return address of all currently 


active procedures. 


EVALUATE Display numeric constant or expression in all five 
possible output radixes. 


Display RQGT Display whether Request/Grant lines operate 
continuously or only while in emulation mode. 


Display BUS Display what device currently controls the system 
bus. 
Discussion 
Registers 


The 8086 register structure contains three files of four 16-bit registers and a set of 
miscellaneous registers. The three files of registers are the general register file, the 
pointer and index file, and the segment register file. The miscellaneous set consists 
of the instruction pointer, flag register, CAUSE register, OPCODE register, PIP 
register, TIMER register, HYIMER register, and BUFFERSIZE register. The 
register structures are described in the following paragraphs. 
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Table 7-9. Classes of Hardware Elements 


| | ClassName | Hardware Elements | : 


general-register 16-bit work register 
pointer-register 16-bit address register 


index-register 16-bit address register 
segment-register 16-bit segment reference register 
status-register 8- and 16-bit status registers 


General Register File. The RAX, RBX, RCX, and RDX registers compose the 
General Register File. These registers participate interchangeably in 8086 arithmetic 
and logical operations. These registers are assigned the following mnemonics: 


RAX: Accumulator 
RBX: Base Register 
RCX: Count Register 
RDX: Data Register 


The general registers are unique within the 8086 as their upper and lower bytes are 
individually addressable. Thus the general registers contain two 8-bit register files 
called the H file and L file as illustrated below: 


RAX: 
RBX: 
RCX: 
RDX: 


General Register File 


Pointer and Index Register File. The BP,SP,SI, and DI set of 16-bit registers is 
called the Pointer and Index Register File. The registers in this group are similar in 
that they generally contain offset addresses used for addressing within a segment. 

_ They can participate interchangeably in 16-bit arithmetic and logical operations. 
They are also used in address computation. The mnemonics associated with these 
registers are: | 


SP: Stack Pointer 
BP: Base Pointer 

Sl: Source Index 

DI: Destination Index 


The pointer and index registers are illustrated below: 


- Pointer and Index Register File | 
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Segment Register File. The CS,DS,SS, and ES registers constitute the Segment 
Register File. These registers provide a significant function in the memory address- 
ing mechanisms of the 8086. They are similar in that they are used in all memory 
address computations. The mnemonics associated with these registers are: 


CS: Code Segment Register 
DS: Data Segment Register 

SS: Stack Segment Register 
ES: Extra Segment Register 


The contents of the CS register define the current code segment. All instruction 
fetches are taken to be relative to CS using the instruction pointer (IP) as an offset. 


The contents of the DS register define the current data segment. All data references 
except those involving BP,SP, or DI in a string instruction, are taken by default to 
be relative to DS. | 


The contents of the SS register define the current stack segment. All data references 
which implicitly or explicitly involve SP or BP are taken by default to be relative 
to SS. 


The contents of the ES register define the current extra segment. The extra segment 
has no specific use, although it is usually treated as an additional data segment. 


The segment registers are illustrated below: 


CS: 
DS: 
SS: 
ES: 


Segment Register File 


Status Register 


The instruction pointer, flag register, CAUSE register, OPCODE register, PIP 
register, TIMER register, HTIMER register, BUFFERSIZE register, UPPER 
register, and LOWER register constitute the status register set. These registers pro- 
vide a variety of functions to the emulator. These registers are assigned the following 
mnemonics: 


IP: Instruction Register 

RF: Flag Register 

CAUSE: CAUSE Register | 
OPCODE: OPCODE Register 

PIP: Previous Instruction Register 
TIMER: TIMER Register 

HTIMER: HTIMER Register | 
BUFFERSIZE: BUFFERSIZE Register 
UPPER: UPPER Register 

LOWER: LOWER Register 


The content of the IP register defines the offset to the CS register in instruction 
address computations. The Flag Register contains the status flag values. The 
CAUSE register is used to retain the cause of the last break in emulation. The 
OPCODE register stores the opcode fetched in the last instruction-fetch cycle in 
trace data. The Previous Instruction Register is used to store the displacement part 
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of the address of the last instruction-fetch in trace data. TIMER contains the low- | 


order 16 bits of the 2-MHz timer indicating how long emulation has run (read only). 
HTIMER contains the high-order 16 bits of the timer (read only). BUFFERSIZE 
contains the count (displayed in decimal only) of frames of valid trace data collected 
in the trace buffer (16 bit, read only). The UPPER register contains the highest 
available address in ICE-86A workspace below the symbol table. The LOWER 
register contains the lowest address available in ICE-86A workspace above the ICE 
software. | 


The status registers are illustrated below: 


IP: 

RF: 

CAUSE: 
OPCODE: 
PIP: 

TIMER: 
HTIMER: 
BUFFERSIZE: 
UPPER: 
LOWER: 


Status Registers 


The Flag Register (RF) contains nine status values, each one a bit in length. The 
following mnemonics are assigned to each of the status values in the register: 


AFL: Auxiliary-carry 
CFL: Carry 

DFL: Direction 

IFL: Interrupt-enable 
OFL: Overflow 

PFL: Parity 

SFL: Sign 

TFL: Trap 

ZFL: Zero 


AFL is set if an instruction caused a carry out of bit 3 and into bit 4 of a resulting 
value. CFL is set if an instruction caused a carry or a borrow out of the high order 
bit. DFL controls the direction of the string manipulation instructions. IFL enables 
or disables external interrupts. OFL is used to denote an overflow condition in a 
signed arithmetic operation. SFL is used to indicate the sign of the result of an 
operation. TFL is used to place the processor in a single-step mode for program 
debugging. ZFL is used to indicate a zero valued result of an instruction. The posi- 
tion of the status bits in the RF Register are shown below: 


11 


10 9 8 7 6 5 4 3 2 1 0 


15 14 3° «12 
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The CAUSE Register is used to store the cause for the last break in emulation. The 
byte returned by the ‘‘Read Break Cause’” hardware command contains the follow- 
ing bit values: if bit = 1, then the specified condition is true, otherwise false. Each bit 
has associated with it a message that is displayed if the bit is true when the software 
command, CAUSE, is entered. 


Bit Position Condition String 
0 Breakpoint 0 matched ‘BRO’ 
1 Breakpoint 1 matched ‘BR1’ 
2 Both breakpoints matched sequentially ‘SEQ’ 
3 Guarded memory access occurred ‘GUARD’ 
4 User aborted processing ‘ABORT’ 
5 Timeout on user READY ‘RDYTO’ 
6 Timeout on user HOLD ‘HLDTO’ 
7 External Break ‘EXTRN’ 


BRO and BRI occur when emulation is halted due to matching the condition set in 
the corresponding break register. Use of the breakpoint registers is discussed in 
Chapter 6. SEQ occurs when emulation is halted due to matching both breakpoint 
registers during the same instruction. For example, BRO can be set for the address of 
an instruction while BRI is set for the value at that address, i.e., the instruction 
opcode. Then, when the specified instruction is fetched from the specified address, 
SEQ is the break condition displayed. GUARD occurs when memory that was not 
mapped is accessed. Memory mapping is discussed in Chapter 7. ABORT occurs 
when the user presses the escape key to halt emulation. RDYTO occurs when emula- 
tion is halted because of a ready timeout error. See Chapter 6 and Appendix B. 
HLDTO occurs when emulation is halted because of a hold timeout error. See 
Appendix B. EXTRN occurs when the user halts emulation through the external 
break line in the buffer box. See Chapter 1 for a description of this line. | 


Pin References 


In addition to the status registers, the ICE-86A emulator provides access to eight 
8086 pins. The following mnemonics are assigned to reference the 8086 processor 
pins shown below: 


Mnemonic _ 8086 Pin 

RDY READY 

NMI NMI 

TEST TEST 

HOLD HOLD 

RST RESET 

MN MN/MX 

IR. INTR. 

RQGT, BUS RQ/GT0, RQ/GT1 (HOLD, HLDA) 


General Formats for Numeric Values 


The ICE-86A emulator displays numeric values in a variety of formats depending 
upon the type of the numeric value. Table 7-10 defines the display formats for each 
of the non-real numeric types. 
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Table 7-10. Numeric Value Display Formats 


es 


BYTE byte An 8-bit value displayed in the current base. 


SINTEGER sinteger sign byte-number (short integer number) 


WORD word 


A 16-bit value displayed in the current base. 


INTEGER integer sign word 
sign 


bit 


POINTER pointer base : displacement H 


base 4 hexadecimal digits (the base value of pointer) 


displacement 4 hexadecimal digits (the displacement value of pointer) 


If the high order bit of an INTEGER or SINTEGER is 1, the numeric value is com- 
plemented and the sign is set negative (‘‘—’’). For example, FFH is displayed as 
—01H as SINTEGER and FOOOH is displayed as -OFFFH as INTEGER. 


In base ASCII, a pair of apostrophes enclose a single character in the case of a byte 
value or encloses two characters if a word value is to be displayed. In the case of a 
word, the high order byte appears on the left of the character pair. 


In the four numeric bases, the BYTE and WORD values have a suffix and sufficient 
leading zeroes to contain the following number of digits. 


Hexadecimal Decimal Octal Binary 
BYTE 2 3 3 8 
WORD 4 5 6 16 


The real numeric types are REAL, DREAL, and TREAL. In general, these types 
share the same characteristics. Any real value is entered in decimal base (no matter 
what the current base is), may be preceded by a sign, and must consist of at least a 
single digit followed by a decimal point. The decimal point may be followed, in 
order, by several more digits, the letter E (flagging the start of an exponent), a sign, 
and a few more digits representing the magnitude of the exponent. Signs are 
optional; their absence is interpreted as meaning a positive value. Exponent digits 
cannot be entered without the letter E preceding them, and the letter E cannot be 
entered without at least one digit preceding it and one digit directly following it. 


Examples: 


*REA 100H = 2., 52., 124341.23E27, —1.2307, + 4.001172E-25, 123243.0E12 


The display of real values follows the same rules as their entry, with the added 
restrictions that only one digit precedes the decimal point, the maximum allowable 


number of digits directly follows the decimal point, and there is always a signed 


exponent value. 
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Example: 
*REA 100 LEN 6 
REA 0000:0100H=+2.00000000E+0 +5.20000000E +1 
REA 0000:0108H=+1 .24341231E+32 —1.23070002E+0 


REA 0000:0110H=+4.00117203E-—25 +1.23243004E+17 


The real numeric types differ both in the precision and the magnitude of the absolute 
values they may represent. The maximum number of digits that may surround the 
decimal point and follow the letter E varies for each of the real types. Their format is 
displayed below: 


REAL = <sign> <digit> . <eight digits> E <sign> <two digits> 
DREAL = <sign> <digit> . <sixteen digits> E <sign> <three digits> 
TREAL = <sign> <digit> . <seventeen digits> E <sign> <four digits> 


The minimum positive and negative values (the values closest to zero) and the max- 
imum positive and negative values (the values closest to infinity) are shown in the 
chart below in normalized form: 


Minimum Positive and Negative Values Maximum Positive and Negative Values 


REAL +1.17549435E-38 +3.40282347E + 38 
DREAL = +2..225073858507201 4E-308 +1.7976931348623157E + 308 
TREAL = +3.36210314311209351E-4932 +1.189731 495357231 76E + 4932 


If the maximum values (positive or negative) are exceeded, an overflow error 
message 1s displayed: : 


ERR BF:REAL NUMBER OVERFLOW 


However, if the minimum values (positive or negative) are exceeded, no error 
message is displayed and the value 0 is used. 


NOTE 


The ICE-86A emulator does not support expressions containing real values. 
While real values may be entered into memory or displayed from memory, 
no arithmetic can be performed involving them. 


The Display Processor and Status Register Command allows you to display any of 
the 8-bit and 16-bit registers, the status flags and 8086 pin values. All referenced 
items are displayed on one line separated by spaces. However, if any displayed value 
would extend beyond column 80, a new line of display is initiated. Each reference is 
displayed according to the appropriate format shown below. The names are trun- 
cated to three characters. 

8-bit-register-name = byte 

16-bit-register-name = word 

status-flag-name = bit 

pin-name = bit 


Example |: 


“RAX, RBH, SP, CAUSE, AFL, HTIMER, BUFFERSIZE 
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Display: 
RAX=0001H RBH=2FH SP=FFE7H CAU=NONE AFL=1 HTI=008EH BUF=D1A2H2H 
Example 2: | 
*REGISTER 
Display: 


RAX=0000H RBX=00A2H RCX=0001H RDX=0010H SP=000AH BP=0000H SI=0123H DI=0000H 
CS=0000H DS=FF1IEH SS=0000H ES=0000H RF=0000H IP=FABCH 


Example 3: 
FLAG 
Display: 
CLF=0 PFL=0 AFL=0 ZFL=0 SFL=0 TFL=1 IFL=0 DFL=0 OFL=0 
Example 4: 
PIN | 
Display: 
RDY=1 NMI=0 TES=1 HOL=0 RST=0 MN=1 IR=0 
Example 5: 
UPPER 
Display: 
UPP = F680H 
In the case of the CAUSE register, the appropriate messages are displayed instead of 
the actual value stored in the register. (If CAUSE is typed prior to running emula- 
tion, then the string ‘NONE’ is returned.) No more than one string can be displayed 


at any given time (there can be only one cause for emulation halt at any given time). 


Examples: 


EMULATION BEGUN <esc> _ 

EMULATION TERMINATED, CS:IP = <XXXX>+<XXXX>H 
CAUSE 7 | 
CAU=ABORT 


The CAUSE register, however, can still be used as part of expressions; in this con- 
text, the actual value stored in the CAUSE register is accessed. 


Examples: 


CAU 
CAU=ABORT 
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.TEST=CAU+0010H 
TEST 
.TEST=0020H 


The Display Memory command enables you to display a range of one or more 
memory locations. When displaying memory, the format of the display depends 
upon the memory type, given either explicitly by a mem-type or implicity by the type 
of a symbol in a typed-memory-reference. For example, suppose that ten con- 
secutive bytes of memory contain ASH, 81H, 34H, OCOH, 15H, OFFH, 77H, 86H, 
45H, and 54H. The following are sample outputs in each of the four bases: hexa- 
decimal, decimal, octal and binary: 


Memory Hexadecimal Decimal Octal Binary 

Type 

BYTE ASH 165T 2450 10100101Y 
WORD 81A5H 33189T 100645 Q 1000000110100101Y 
SINTEGER -—5BH —91T —133Q -01011011Y 
INTEGER -7E5BH —32347T -77133 Q —0111111001011011Y 
POINTER C034:81A5H — — —_ 
REAL _ —2.82041287E+0 —_ — 

DREAL — —1.6921176799917261E-277 — — 

TREAL —_— +2.32856759329006744E +1562 —_ — 


In addition to displaying real numeric values, there are three character strings that 
may be displayed for real values under special circumstances. These are ‘“‘++,”’ 
‘‘—— >> and ‘‘..”’ which refer, respectively, to positive infinity, negative infinity, and 
not anumber (NAN). . 


The user cannot enter these character symbols (++, ——, and ..) directly as values for 
real numbers. However, infinity can be entered indirectly by typing the byte value of 
the representation of a floating point number that overflows the intended real 
numeric data type. The following examples illustrate how this can be done when 
REAL is the intended data type. The overflow value can be entered with the BYTE 
command. , | 


*BYTE 0=0, 0, 80, 7F 
*REAL 
REA 0000:0000H=++ 


The result in this case is positive infinity. 


*BYTE 0003H=0FFH 
*REAL 
REAL 0000:0000H=—— 


Changing the MSB to OFFH changes the sign to produce negative infinity. 


*BYTE 0000H=0FFH, OFFH, OFFH, OFFH 
*REAL | 
REA 0000:0000H=.. 


Storing binary | in all four bytes results in NAN or not a number. 


Usually, these conditions occur when the 8087 NDP is used with the 8086. The 
8087 may return infinity as the overflow result of a computation or as the result 
of a divide by zero computation. A NAN may be generated by the 8087 as an 
indefinite result, for example, when an uninitialized variable is detected. 
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These data types are discussed in detail in The 8086 Family User’s Manual 
Numerics Supplement, Manual Order Number 121586. Further information on 
real data-type memory storage is also available in ‘‘Set Memory and Port Con- 
tent Commands’’ in Chapter 7. 


The Display memory command permits you to display more than one line of 
_memory values. Each line of display contains the memory address of the first value 

displayed on that line followed by a maximum number of values as indicated by 
table 7-11. 


Table 7-11. Display Values Per Line 


16 8 4 64 


BYTE 


WORD 
SINTEGER 
INTEGER 
POINTER 


Table 7-1 refers only to non-real memory types. Real memory types—REAL, | 


DREAL, and TREAL—display only in decimal base and always display a maximum 
of two values per line. 


REAL, DREAL, and TREAL values can be accessed and modified independent of 
the present base; BASE = T is always implied for REALs. | 


Following are examples of memory display in all four bases. As displays of real | 


numeric type memory will always appear in decimal format, no matter what the cur- 
rent base is, examples of REAL, DREAL, and TREAL will be given only in the sec- 
tion where BASE=T; this is not meant to imply that real values cannot be accessed 
when BASE is not set to T. 


Assume that the following memory locations contain the values shown below (in 
hexadecimal): — 


Address Content 

00000H OOH 41H 42H 43H 45H 20H 30H 3DH 74H 68H 65H 72H 20H 43H 61H 6CH 
00010H 69H 66H 6FH 72H 6EH 69H 61H ODH OAH 20H 20H 20H 20H 20H 20H 20H 
00020H 20H 20H 20H 6CH 61H 77H 20H 70H 72H 6FH 76H 69H 64H 65H 64H 20H 


00030H 66H 6FH 72H 20H 70H 72H 6FH 67H 72H 61H 6DH 73H 20H 6FH 66H 20H 
00040H 74H 68H 69H 73H 20H 73H 6FH 72H 74H 2EH 20H 20H 54H 68H 69H 73H 


The following commands display the above memory values with BASE = H: 

Example 1: | | 
BYTE 0000:0030 

Display: 


BYT 0000:0030H=66H 
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Example 2: 

BYT 0:30 TO 0:3F 
Display: 

BYT 0000:0030H=66H 6FH 72H 20H 70H 72H 6FH 67H 72H 61H 6DH 73H 20H 6FH 66H 20H 
Example 3: 

WORD 0000:30° 
Display: 

WOR 0000:0030H=6F66H 
Example 4: 

WOR 0:30 LEN 10H 
Display: 


WOR 0000:0030H=6F66H 2072H 7270H 676FH 6172H 736DH 6F20H 2066H 
WOR 0000:0040H=6874H 7369H 7320H 726FH 2E74H 2020H 6854H 7369H 


Example 5: 
POINTER 0:30 
Display: 
POI 0000:0030H=2072:6F66H. 
Example 6: 
POI 0:30 TO 0:3C 
Display: 
POI 0000:0030H=2072:6F66H 676F:7270 736D:6172H 2066:6F20H 
Example 7: 
POI 0:30 TO 0:50 
Display: 
PO! 0000:0030H=2072:6F66H 676F:7270H 736D:6172H 2066:6F20H 
POI 0000:0040H=7369:6874H 726F:7320H 2020:2E74H 7369:6854H 
PO! 0000:0050H=756F :6420H 
The following examples illustrate display in decimal (BASE=T): 
Example 8: 


BYTE 0000:0030 


Display: 


BYT 0000:0030H=102T 
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Example 9: 
BYT 0:30 TO 0:3F 


Display: 


BYT 0000:0030H=102T 1117 1147 032T 112T 114T 117 103T | 
BYT 0000:0040H=114T 097T 109T 115T 032T 111T 102T 032T 


Example 10: 
WORD 0:30 
Display: 


WOR 0000:0030H=28518T 


Example |1: 


WORD 00:30 TO 00:4E 


Display: 


WOR 0000:0030H=28518T 08306T 29296T 26479T 24946T 29549T 28448T 08294T 
WOR 0000:0040H=26740T 29545T 29472T 29295T 11892T 08224T 26708T 29545T 


Example 12: 
POINTER 0:30 
Display: 


POI 0000:0030H=2072:6F66H 


Example 13: 


POINTER 0:30 TO 0:3C 
Display: 
(same as Example 6.) 
Example 14: 
REAL 0:30 
Display: 
REA 0000:0030H=+2.05350560E—19 
Example 15: 
REAL 0:30 TO 0:3F 
Display: 


REA 0000:0030H=+2.05350560E—19 
REA 0000:0038H=+1 .88072324E+31 


+1.13075659E+24 
+1.95185260E-19 
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Example 16: 
DREAL 0:30 TO 0:3F 
Display: 
DRE 0000:0030H=+1.751 4059685946888E +190 +1 .3385686327532207E-152 
Example 17: 
TREAL 0:30 TO 0.3F 
Display: 


TRE 0000:0030H=+0.42394727402142709E+2578 +0.11708909595879081E+3963 


The following examples illustrate memory displays in octal (BASE=Q). 
Example 18: 
BYTE 0000:0030 
Display: 
BYT 0000:0030H=1460Q 
Example 19: 
BYT 0:30 LEN 10H 
Display: 


BYT 0000:0030H=146Q 157Q 162Q 040Q 160Q 162Q 57Q 147Q 
BYT 0000:0040H=162Q 141Q 155Q 163Q 040Q 157Q 146Q 040Q 


Example 20: 
WOR 0:30. 
Display: 
WOR 0000:0030H=067546Q 
Example 21: 
WORD 0:30 LEN 10H 
Display: 
WOR 0000:0030H=067546Q 020162Q 071160Q 063557Q 
WOR 0000:0038H=060562Q 071555Q 067440Q 020146Q 


WOR 0000:0040H=064164Q 071551Q 071440Q 071157Q 
WOR 0000:0048H=027164Q 020040Q 064124Q 071551Q 


Example 22: 


POINTER 0:30 LEN 0D 
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Display: 


(same as Example 6.) 


The following examples illustrate memory displays in binary (BASE=Y). 
Example 23: 
BYTE 0:30 
Display: 
BYT 0000:0030H=0110010Y 
Example 24: 
BYTE 0:30 TO 0:3F 
Display: 
BYT 0000:0030H=01100110Y 01101111Y 01110010Y 00100000Y 
BYT 0000:0034H=01110000Y 01110010Y 01101111Y 01100111Y 
BYT 0000:0038H=01110010Y 01100001Y 01101101Y 01110011Y 
BYT 0000:003CH=00100000Y 01101111Y 01100110Y 00100000Y 
Example 25: 
WOR 0:30 
Display: 
WOR 0000:0030H=0110111101100110Y 
Example 26: 
WOR 0:30 LEN 10H 
Display: 
WOR 0000:0030H=0110111101100110Y 0010000001110010Y 
WOR 0000:0034H=0111001001110000Y 0110011101101111Y 
WOR 0000:0038H=0110000101110010Y 0111001101101101Y 
WOR 0000:003CH=0110111100100000Y 0010000001100110Y 
WOR 0000:0040H=0110100001110100Y 0111001101101001Y 
WOR 0000:0044H=0111001100100000Y 0111001001101111Y 
WOR 0000:0048H=0010111001110100Y 0010000000100000Y 
WOR 0000:004CH=0110100001010100Y 0111001101101001Y 
Example 27: 
POINTER 0:30 
Display: 
POI 0000:0030H=2072:6F66H (Always displayed in hexadecimal.) 
The Display I/O command enables you to display byte ports (PORT) and word 


ports (WPORT) in a manner similar to the Display memory command. Single port 
contents or the contents of a range of ports may be displayed. However, only a 
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single integer is required to specify the port address. The following examples 
illustrate the Display I/O command. The implied suffix in these examples is H 
(hexadecimal) for address specification. 


Example 1: 


BASE =Y 
PORT 120H 


Display: 
POR 0129H=10111111Y 

Example 2: 
PORT 120 LEN 10 

Display: 
POR 0120H=10111111Y 10111111Y 10111111Y 01111111Y 
POR 0124H=10111111Y 10111111Y 10111111Y 01111111Y 
POR 0128H=10111111Y 101741111Y 10111117Y 01111111Y 
POR 012CH=10111111Y 10111111Y 10199117Y 01111111Y 


Example 3: 


BASE=Q 
PORT 120 


Display: 

POR 0120H=277Q 
Example 4: 

PORT 120 TO 12F. 
Display: 


POR 0120H=227Q 177Q 277Q 177Q 277Q 177Q 277Q 177Q 
POR 0128H=277Q 177Q 277Q 177Q 277Q 177Q 277Q 177Q 


Example 5: 


BASE =T 
POR 120 


Display: 

POR 0120H=191T 
Example 6: 

PORT 120 TO 12F 
Display: 


POR 0120H=191T 127T 191T 127T 191T 127T 191T 27T 
POR 0128H=191T 127T 191T 127T 191T 127T 191T 127T 
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Ex ample 7: 


PORT 120 


Display: 

POR 0120H=BFH 
Example 8: 

PORT 120. TO 12F 


Display: 


POR 0120H=BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH 


Example 9: 


BASE =Y 
WPORT 120 


Display: 
WPO 0120H=0111101110111111Y | 

Example 10: 
WPORT 120 TO 12E 

Display: 
WPO 0120H=0111101110111111Y 0111111110111111Y 
WPO.0124H=0111111110111111Y 0111101110111111Y 
WPO 0128H=0111111110111111Y 0111101110111111Y 
WPO 012CH=01111011101111117Y 0111101110111111Y 


Example 11: 


BASE =Q 
WPORT 120 


Display: 

WPO 0120H=077677Q. 
Example 12: 

WPORT 120 TO. 13E 


Display: 


WPO 0120H=077677Q 077677Q 077677Q 075677Q 075677Q. 077677Q. 075677Q. 077677Q 
WPO 0130H=077677Q 077677Q 075677Q 077677Q 075677Q 077677Q 077677Q 075677Q 


Example 13: 


BASE =T 
WPORT 120 
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Display: 

WPO 0120H=32703T 
Example 14: 

WPOPT 120 TO 13E 
Display: 


WPO 0120H=32703T 32703T 32703T 31679T 31679T 32703T 31679T 32703T 
WPO 0130H=32703T 32703T 31679T 32703T 31679T 32703T 32703T 31679T 


Example 15: 


BASE =H 
WPORT 120 


Display: 
WPO 0120H=7FBFH 
Example 16: 
WPORT 120 TO 13E 
Display: 
| WPO 0120H=7FBFH 7FBFH 7FBFH 7BBFH 7BBFH 7FBFH 7BBFH 7FBFH 


WPO 0130H=7FBFH 7FBFH 7BBFH 7FBFH 7BBFH 7FBFH 7FBFH 7BBFH 


The Display STACK causes the top n words of the user’s stack (i.e., user memory 
pointed at by SS:SP) where n is an integer value in the command that specifies the 
number words in the stack to be displayed. 
Example: 

STACK 10 
Display: 


WOR 0000:0000H=4100H 4342H 2045H 3D30H 6874H 265H 4320H 6C61H 
WOR 0000:0010H=6669H 726FH 696EH OD61H 200AH 2020H 2020H 2020H 


The Display Boolean command is used to display the boolean value of an integer 


value contained in the command: © 
Example: 
BOOL FFH 
Display: 
TRUE 
Example: 


BOOL !X = !Y 
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Display: 


FALSE 


The Display NESTING Command 


The Display NESTING command enables you to display the starting and return 
addresses of all procedures that are currently active. The user is scanned for pro- 
cedure starting and return addresses as follows (all references to stack manipulations 
are restricted to the scope of the nesting module only): 


1. Setb=CS 


2. Set d = SP (word at the top of the user stack). If the 5 bytes from (b,d-5) 
through (b,d-1) can be interpreted as a short call (direct or indirect) (2,3, or 4 
bytes), then b,d is assumed to be a return address. 


3. Set WORD temp$b:d = next word on the user stack. If the 5S bytes from 


(temp$b-d) through (temp$b,d-1) can be interpreted as a long call (direct or 
indirect) (2,3,4 or 5 bytes), INT (1 or 2 bytes), or INTO, then b,d (and the next 
word in the stack for INT and INTO) can be assumed to be a return address. 


4. The return address, type of call (i.e., short call direct), INT, or INTO, and the 
starting address (for direct only) are displayed. 


The above procedure is repeated until 16 iterations fail to find a return address or 
the stack memory enters guarded memory. Care should be taken in using this com- 
mand as the above method is susceptible to error. 


The EVALUATE Command 


The EVALUATE command handles the arithmetic computation involved in 
translating integers from one radix to another and computes the 20-bit address of a 
pointer. This command has the form EVALUATE expr, where expr is any numeric 


constant or numeric expression. The expr can also be a predefined reference. 


keyword such as UPPER or LOWER, or it can be an expression containing 
reference keywords. Upon receiving this command, the ICE-86A emulator evaluates 
any expression to a single number. If it is an integer, it displays the result in the four 
bases Y, Q, T, and H, and the corresponding ASCII characters, all on one line. For 
ASCII, the characters are enclosed in single quotes (’); printing characters are 
displayed (ASCII codes 20H through 7EH after bit 7 is masked off), while non- 
printing characters are suppressed. 


When the EVALUATE command is followed by the keyword ‘SYMBOLICALLY’ 
(preceding the carriage return), the numeric value output by the command is 
displayed as asymbol or statement number plus a remainder. The ICE-86A symbols 
and statement numbers are searched to find the one with the same base whose value 
is closest to but not greater than the value being output. In the event that a symbol 
and a statement number have the same value, the symbol is used. The value is then 
displayed as either the selected symbol! plus a numeric-constant or the selected state- 
ment number plus a numeric-constant, where the numeric-constant is the remainder 
in the current output base. If no symbol or statement number has a value less than 
or equal to the number being output, the value is output as a numeric-constant. If 
the remainder is zero, the numeric constant is omitted. 


If the numeric expression has a non-zero base, the value is displayed as a pointer 
(base:disp). 


Here are several examples of the use of the EVALUATE command, with the display 
produced by each one. 
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Example 1: 
EVALUATE 123T 
Display: 
1111011Y 173Q 123T7BH ‘[’ 
Example 2: 
EVA FFH + 256T 
Display: 
411191111Y 777Q 5117 #IFFH °”’ 
Note that the addition was performed first, then the result was displayed in the four 
bases. The result contained only non-printing ASCII characters, displayed as empty 
quotes. 
Example 3: 
EVA 111:0222H SYMBOLICALLY 
Display: 
0111:0222H 
This example assumes that no symbol or statement number match. 
Example 4: 
EVA 111:222H SYM 
Display: 
..MOD1.SAM + 0021H 


This example assumes that a matching symbol with an address at 111:201 has been 
selected. | 


Example 5: 
EVA UPPER-LOWER 
Display: | 
1101100010111 154240Q 6935T 1817H() 
This command will display the difference between UPPER and LOWER, which will 


be the total memory available for symbols and macro expansion. The display will be 
in all bases. -_ 


NOTE 


The EVALUATE command does not process real values. That is, real 
numbers in decimal base cannot be translated by the ICE-86A emulator into 
binary, octal, or hexadecimal, or corresponding ASCII characters. 
Attempting to evaluate a real number produces an error message. 
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The Disassembly Command 


The Disassembly Command allows the user to display instructions in memory in 
disassembled format. (See Display of Trace Data in Instruction Mode, Chapter 6, 
for definition of format.) The syntax of the command appears below: 


DASM address | TO address 
| LENGTH /ength 


The user may specify a single address, or a_ partition of addresses, to be dis- 
assembled and displayed. 7 


The DEFINE DASM Command 


The DEFINE DASM Command Is intended to support disassembly of opcodes nor- 
mally executed by an 8087 Numeric Data Processor. The command alerts the 
ICE-86A disassembler to the hardware/software configuration of the user prototype 
application system as it impacts floating point instruction handling. The syntax of 
the command 1s given below: 


DEFINE DASM {86 
87 
{ EMULATOR 


Initially, DASM is set to ‘‘86’’; this indicates to the disassembler that no special 
floating point hardware or software exists with the 8086 processor, i.e., no special 
interpretation of 8086 ESCape or INTerrupt instructions is required of the 


disassembler in this setting. If the user combines an 8087 NDP with the 8086 CPU, 


then DASM should be defined as ‘‘87’’; the disassembler then interprets ESCape 
instructions as floating point instructions. If the user combines the 8087 emulator 
software package with the 8086 CPU, then DASM should be defined as 
“EMULATOR”; the disassembler then interprets INTerrupt instructions as 
floating point instructions. 


NOTE 


The operator should not display trace when TRA=INS while DASM is 
defined as ‘EMULATOR’? (i.e., the user’s application system is based on 
an 8086 CPU in local mode with the software emulator for the 8087 NDP). 
The trace facility is not capable of interpreting INTerrupt instructions prop- 
erly in this system configuration. That is, when the trace buffer is 
disassembled, it will show that an FP instruction has been executed but the 
operand values will be wrong and the trace will be out of synchronization 
with the actual instruction stream which can be misleading to the user. 


The user should also be aware that when DASM is defined as ‘*87”’ (1.e., the 
user’s application system is based on an 8086 CPU in local mode with the 
harware 8087 NDP), then the trace facility will not record bus activities 
while the 8087 NDP controls the system bus. (As a general principle, the 
trace facility is incapable of recording bus activities whenever a device other 
than the ICE-86A emulator controls the system bus.) 
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Display Processor and Status Registers Command 


reference |,reference]... 


REGISTER 
FLAG 
PIN 
Examples: 
UPPER 
RAX 
“RBH, SI, AFL, HOL 
REGISTER 
R 
FLA 
PIN 
BUS 
reference Any of the reference keywords that reference processor registers, 
status registers, and pins. Also can include memory and I/O in list. 
REGISTER A command keyword requesting the display of the thirteen 16-bit 
8086 registers and RF. 
FLAG A command keyword requesting the display of the nine status 


PIN 


flags. 


A command keyword requesting the display of the contents of the 
seven Input pins. 


Interrogation and Utility Commands | | a ICE-86A 


Display Memory Command 

memory-designator address TO address 

LENGTH /ength 

Examples: 

BYTE 1000:100H 

WOR 0:123 TO 0:200 

SIN 100:0 LENGTH 200 

INT 200:200 

POINTER 200:200 

POI 200:200 TO 200:2FE 


memory-designator One of the following keywords that specify the size and type 
| of memory referenced: 


BYTE A 1-byte (8-bit) integer value. 
WORD A 2-byte (16-bit) integer value. 
SINTEGER A 1-byte (8-bit) short integer number. 
INTEGER __ A 2-byte (16-bit) integer value. 


POINTER A 4-byte (two 16-bit integer) value. 


REAL A 4-byte (32-bit real) value. 
DREAL An 8-byte (64-bit real) value. 
TREAL A 10-byte (80-bit real) value. 
address A pointer value containing a base and a displacement that 


together specify an address of a memory location. 


TO A partition keyword that denotes that an address ts to follow. 
This address defines the upper bound of the required range of 
addresses in the partition. 


LENGTH A partition keyword that denotes that a Jength value is to 
follow. 
length | An integer value specifying the number of addresses to be 


contained in the partition (bytes, words or pairs of words, 
depending on memory-designator ). 
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Display |/O Command 

PORT TO address 

WPORT LENGTH /ength 
Examples: 

PORT FF12H 

POR FF00 TO FFFF 

POR 1000 LEN 200 

WPORT 123H 

WPO 100 TO 200 

WPO 100 LENGTH 101 

PORT Keyword reference to 8086 8-bit I/O port(s). 

WPORT Keyword reference to 8086 16-bit I/O port(s). 

address An integer value that specifies the address of an 8086 port. 

TO A partition keyword that denotes that an address is to follow. 
This address defines the upper bound of the required range of 
port addresses in the partition. 

LENGTH A partition keyword that denotes that a length value is to 
follow. 

length An integer value specifying the number of port addresses 


(byte or word ports) to be contained in the partition. 
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Display STACK Command 
STACK expression 


STACK 10H 
STA .SAM 
STACK .SAM + 20 


STACK A command keyword that requests the display of the contents of 
the user’s stack. The stack is located in user memory referenced by 
the pointer value SS:SP. | 


expression An integer expression. The value of this expression defines the 
: number of words at the top of the STACK that are to be displayed. 
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Display Boolean Command 


BOOL expression 
Examples: 


BOOL FFH 

BOO CS=DS AND IP > 50 
BOO BYTE .X=F2H 
BOOL !SAM 

BOO2 CFL 


BOOL A command keyword requesting the display of the boolean value 
(TRUE, FALSE) of the input value, expression . 


expression A boolean expression. The value of this expression is evaluated to a 
boolean value. If the least significant bit of the expression = 1, the 
boolean value is TRUE, otherwise the boolean value is FALSE. 
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Display NESTING Command 
NESTING 

angle 
NESTING 


NESTING A command keyword that causes the display of each CALL, INT, | 
and INTO instruction that is currently active. 
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EVALUATE Command 

EVALUATE numeric-expression [SYMBOLICALLY] 
Examples: 

EVALUATE UPPER-LOWER 

EVALUATE 123T 

EVALUATE 4142H 


EVALUATE FFH + 256T 


EVALUATE A command keyword that directs the ICE-86A emulator to 
evaluate the expression and display the result in all four number 
bases and ASCII. 

numeric A numeric expression, numeric constant, predefined reference 

expression keyword, or an expression containing such a keyword. 


SYMBOLICALLY This keyword causes each numeric value output by the command to 
be displayed as a symbol or source statement number plus a 
remainder. The ICE-86A symbols and source statement numbers 
are searched for the one with the same base whose value is closest to 
but not greater than the value being output. In case a symbol and a 
statement number have the same value, the symbol is used. The 
value is then displayed as either a symbolic reference plus a numeric 
constant or a source statement number plus a numeric constant 
where the numeric constant is the remainder in the current output 
base. If no symbol or statement number has a value less than or 
equal to the number being output, then the value is output as a 
numeric constant. If the remainder is zero, the numeric constant is 
omitted. 
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_ Disassembly Command 
-pASMadaress[TOaddress 7] 
LENGTH /ength 


Examples: 


DASM 1000:123 
DASM 1000:123 TO 1000:400 
DASM 2000:0000 LEN 100 


DASM A command keyword specifying the display of instructions in 
disassembled format. 7 


address A pointer value containing a base and displacement that together 
_— specify an address of a memory location. 


TO: A partition keyword that denotes that an address is to follow. This 
address defines the upper bound of the required range of addresses 
in the partition. 

LENGTH A partition keyword that denotes that a /Jength value is to follow. 

length An integer value specifying the number of addresses to be 


contained in the partition (bytes, several bytes in succession, words, 
or pairs of words, depending on memory type). 
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DEFINE DASM Command 


DEFINE DASM { 86 


Examples: 


87 
EMULATOR 


DEFINE DASM 86 


DEF DASM 87 


DEF DASM EMULATOR 


DEFINE 


DASM 


86 


87 


EMULATOR 


Command keyword that informs the ICE-86A emulator that the 
value of the following facility is to be set. 


Command keyword that indicates the mode of disassembly. 


Indicates that the user’s application system consists of an 8086 
processor without hardware or software support of floating point 
arithmetic. 


Indicates that the user’s application system consists of an 8086 
processor in local configuration with an 8087 NDP. 


Indicates that the user’s application system consists of an 8086 
processor equipped with the software package that emulates the 
8087 NDP. 


CHAPTER 8 


ICE-86A™ ENHANCEMENTS 


The command features described in this chapter enhance the operation of the 
ICE-86A emulator by extending the power of the simple ICE-86A commands. 


ICE-86A emulator enhancements are of two kinds: compound commands and 
macro commands. These features are as follows. 


Compound commands 


REPEAT command 
COUNT command 
IF command 


Macro commands 


DEFINE MACRO command 

Invoke macro command 

Display macro command 
ENABLE/DISABLE EXPANSION command 
Macro directory command 

REMOVE MACRO command 

PUT MACRO command 


Please note that the examples in this chapter are independent of each other. The 


introduction to each example gives the initial conditions for that example, and does 
not assume any results or conditions from any previous examples. 


Compound Commands | 


A compound command is a control structure that contains zero or-more commands. 


The compound commands discussed in this chapter are the REPEAT, COUNT, and . 


IF commands; the DEFINE MACRO command is also a type of compound com- 
mand. As the command titles indicate, REPEAT and COUNT are looping com- 
mands, and IF establishes conditional execution, and DEFINE MACRO establishes 
a named command block. All compound commands can have a “‘local’’ setting for 
the default SUFFIX (console input radix), as described under Local and Global 
Defaults in this chapter. 


REPEAT Command 


The REPEAT command executes zero or more ICE commands in a loop; the loop 
can also contain zero or more logical conditions for termination. 


The REPEAT command consists of the REPEAT keyword, zero or more com- 
mands of any type, zero or more exit conditions using WHILE or UNTIL, and the 
keyword END. Enter each of these elements on its own line of the console display; 
terminate each input line with an intermediate carriage return (shown as cr in the 
command syntax). The syntax for REPEAT can be shown as follows: 


REPEATcr 
command cr 
WHILE boolean-expression cr 
UNTIL boolean-expression cr 
END. 
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After each intermediate carriage return, the ICE emulator begins the next line witha 
period (giving an indented appearance), then the asterisk prompt to signal readiness 
to accept the next element. After the END keyword, enter a final carriage return to 
begin the sequence of execution. The final carriage return after END is not shown in 
the syntax, since all commands terminate with a final carriage return. The END 
keyword can be entered as ENDR or ENDREPEAT; the characters after END serve 
as a form of “‘comment’’ to indicate which loop is being terminated. 


The elements to be repeated are shown in brackets in the syntax. Each element can 
be a command, a WHILE clause, or an UNTIL clause. You can mix these elements 
in any order, using any number of each type of element. 


Each command is executed when it is encountered on each iteration. After the com- 
mand has been completely executed, the loop proceeds to the next element. 


The WHILE and UNTIL keywords introduce exit clauses. The WHILE clause ter- 
minates execution of the loop when its boolean-expression evaluates FALSE. The 
UNTIL clause terminates the loop when its boolean-expression evaluates TRUE. | 


In both the WHILE and UNTIL clauses, the boolean-expression is evaluated each 
time the clause is encountered; that is, once per iteration. Evaluation at each itera- 
tion involves looking up the values of any references in the expression. Thus, the 
result can change with each evaluation. Refer to Chapter 5 for an explanation of 


how expressions are evaluated. 


The choice of WHILE or UNTIL is usually a matter of convenience—there is always . 


a way to convert one into the other. For example, ‘‘WHILE bool-expr’’ 1s 
equivalent to ‘SUNTIL NOT (bool-expr)’’. 


NOTE , me 
To terminate execution of a REPEAT (or COUNT) loop, press the ESC key 
at the console. The ICE command currently executing halts wherever it hap- 
pens to be; if you are emulating, the current instruction is completed before 
the break. The ICE emulator responds to the ESC with the asterisk prompt. 


Here are some brief examples of the REPEAT command. | 


Example 1: Generate an ASCII table similar to Table 5-2. _ 


DEFINE .TEMP = 40H 
REPEAT 
WHILE .TEMP <=7EH 
EVALUATE .TEMP 
TEMP = .TEMP +1 
ENDR 


Example 2: Single-step through the user program and display the trace data col- 
lected for each instruction until a repetitious routine (. DELAY) is reached. 


TRACE = INSTRUCTIONS 
CS =SEG .START 
IP = OFF .START 
REPEAT 
UNTIL CS:IP = .DELAY 
STEP | 
PRINT -1 
ENDR 
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Example 3: Using a complex combination of conditions in the boolean expression. 


REPEAT 
UNTIL (CS:IP > .END XOR !VAR1 = 0) AND (. TEMP > 0 XOR !VAR2 = 1) 
STEP 
REGISTER 

ENDR 


Example 4: Emulate from the start of the program (.START) until a breakpoint 
(END EXECUTED) is reached, display status registers, then continue emulating, 
halting, and displaying status until a terminating condition (BYTE .VAR = 2) Is 
reached. 7 


CS = SEG .START 

IP = OFF .START 

REPEAT 
GO TILL .END EXECUTED 
REGISTER 
UNTIL IVAR = 2 

ENDR 


COUNT Command 


Like REPEAT, the COUNT command sets up a loop. In addition to the WHILE 
and UNTIL clauses discussed under REPEAT, COUNT includes a loop counter that 
terminates the loop if no exit condition is met before the counter runs out. 


The COUNT command has the form: 


COUNT arithmetic expression cr 

| command cr 

| WHILE boolean-expression cr 
| UNTIL boolean-expression cr 
END 


The arithmetic-expression after COUNT controls the (maximum) number of itera- 
tions to be performed. If a numeric constant is used (for example, COUNT 10), the 
ICE emulator interprets it in implicit decimal radix; in other words, any number 
entered after COUNT without an explicit radix is interpreted as a decimal number. 


If the entry after COUNT is an arithmetic-expression, it is evaluated to give the 
number of iterations. The COUNT expression is evaluated once, before any loop 
elements are encountered. It is not evaluated again on any interation. The COUNT 
expression uses the values of any references it contains as they stand at the time of 
evaluation. For example, consider the following command sequence: 


DEFINE .XX = 2 
COUNT .XX 

XK = XK +1 
END 


- This loop goes through two iterations, although .XX has value 4 when the loop 


terminates. 
The loop terminates when the number of iterations. given by the COUNT expression 


has been performed or when an exit condition is tested and causes exit, whichever 
comes first. The following example illustrates this concept: 
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DEFINE .XX =1 
COUNT 5 
XX = .XX+1 
WHILE .XX <5 
END 


To show that the loop terminates on the WHILE condition before the COUNT 
expression is exhausted, we can ‘‘track’’ the loop in operation. Table 8-1 shows the 
track. 


Table 8-1. Tracking a COUNT Command 


The loop terminates during the fourth iteration, when .XX < 5 becomes FALSE. 


Conversely, the COUNT expression specifies the maximum number of iterations to 
be performed in case no exit clause produces an exit on any iteration. For example: 


TRACE = INSTRUCTION 
CS = SEG .START 
IP = OFF .START 
COUNT 10 
UNTIL CS:IP =. DELAY 
STEP 
PRINT —1 
END 


In this command, the COUNT expression specifies a maximum of ten STEPs, in 
case the first instruction at . DELAY. is not reached during any iteration. 


With a REPEAT command or with a COUNT command that includes one or more 
clauses, there may be no direct way to tell how many iterations occurred before the 
loop terminated. For these cases, you can insert a loop counter as a loop element. 
For example, to obtain table 8-1 as a display (or LIST file output), you could use the 
following sequence: | 


BASE =T 
DEFINE . ITER=0 
DEFINE. XX =1 
COUNT 10 
XX = XX +1 
ATER = ITER +1 
TER 
XX 
BOOL .XX<5 
WHILE .XX <5 
END 


The command BOOL .XX <5 produces a display of TRUE or FALSE. 


The following example emulates to a breakpoint, displays status registers, then con- 
tinues emulating, breaking, and displaying status for a definite number of iterations: 


5 “Se x 


CS = SEG .START 
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IP = OFF .START 

COUNT 10 
GO TILL .PAUSE EXECUTED 
REGISTER 

END 


IF Command 


The IF command permits conditional execution in a command sequence. The IF 
command has the form: 


IF boolean-expression [THEN] cr 
[command cr]... 


ORIF boolean-expression [THEN] | 
[command cr] ... 


-— cr | 
[command cr}... 


END 


The command must have the IF clause; the ORIF and ELSE clauses are optional. 
The command can include as many ORIF clauses as desired. The IF and ORIF 
clauses each contain a single condition (boolean expression). Any clause can contain 
none, one, or more commands. A clause with no commands simply produces an exit 
when its condition is TRUE. 


The ICE emulator examines each boolean expression in turn, clause by clause, look- 
ing for the first TRUE condition. If a TRUE condition is found, the commands in 
that clause are executed and the IF command terminates. If none of the conditions is 
TRUE, the commands in the ELSE clause are executed and the IF command ter- 
minates. If the ELSE clause is omitted and no condition is TRUE, the IF command 
terminates with no commands executed. 


The END keyword is required to close off the IF command; it can be written as 
ENDIF to clarify nesting. _ 


Here is an example of the IF command: 


BASE = T 

IP =1 

IF IP<1 
EVALUATE 1 

ORIF IP <2 
EVALUATE 2 

ORIF IP-< 3 
EVALUATE 3 

ELSE 
EVALUATE 4 

END 


This example displays the result of EVALUATE 2 and then terminates. The first 
condition (IF IP < 1) is FALSE, so EVALUATE | is skipped. The second condition 
(ORIF IP < 2) is TRUE, so EVALUATE 2 is executed and the IF command ter- 
minates. The third condition (ORIF IP < 3) is not tested, even though it happens to 
be TRUE. ~ 
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In practice, however, the IF command is useful when it is nested ina REPEAT or 


COUNT loop rather than appearing at the ‘‘top’’ level. The reason for this is that 
you want to test conditions that can change (due to other commands in the loop), 
whereas at the top level the TRUE or FALSE state of any condition is known, or can 
be determined with the BOOL command. Thus, the result from the previous exam- 
ple can be obtained with fewer steps: “ 


BOOLIP<1 (Displays FALSE) 
BOOLIP<2 (Displays TRUE) 
EVALUATE 2 


Nesting Compound Commands 


The REPEAT, COUNT, and IF commands can be nested to provide a variety of 
control structures. 


Each nested compound command must have its own END keyword. When entering 
a nested command sequence, you may wish to use the keywords ENDR, ENDC, and 
ENDIF, to help you keep straight which command you intend to close off. The ICE 
emulator does not check nesting levels at entry, and if an END is omitted, the 
resulting error makes it necessary to enter the entire command again. 


Each nested REPEAT or COUNT command can contain its own exit clauses 
(WHILE or UNTIL). Each such exit clause can terminate the loop met contains it, 
mat has no effect on any outer loops or commands, 


As an example of nesting, suppose you want to STEP through a program with trace 
display, but skip a repetitive timeout routine, .DELAY, that is called with an 8086 
short-call instruction several times during program execution. One way to achieve 
this effect is with the following command sequence: 


TRACE = INSTRUCTION 
CS = SEG .START 
IP = OFF .START 
REPEAT 
IF CS:IP = .DELAY 
IP = WORD SS:SP 
SP=SP + 2 
ENDIF 
STEP 
PRINT —1 
ENDR 


At each call to . DELAY in the program, the displacement of the return address for 
the call is pushed on the stack. The keyword SP refers to the stack pointer, and SS 1s 
the stack segment register; SS:SP is the address of the top of the stack where the 
return address is stored. The effects of the commands IP = WORD SS:SP and SP = 


SP + 2 are to load the return address back into IP and reset the stack os just as 


if the return instruction at the end of .DELAY had been executed. 


As another example of nesting, suppose the user code at statements #21 and #22 is 


incorrect or not written yet. The following sequence emulates to the point where 


substitute code is to be inserted, inserts the code (equivalent to IF MARK > 0 THEN 
PTR = PTR +2 in PL/M), then continues emulating beginning with statement #23 
(the insertion is made any time emulation reaches statement #21): 


GO FROM .START TILL #21 EXECUTED 
REPEAT 
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IF IMARK > 0 
IPTR=!PTR + 2 
ENDIF 
GO FROM #23 
ENDR 


An exit can be made only when a condition is tested, not when it occurs. To cause an 
exit, the test must be placed at the point in the loop where the condition occurs. For 
example, consider the following command sequence: 


CS =SEG .START 
IP = OFF .START 
REPEAT 
UNTIL IP = 1000H 
STEP 
ENDR 


In this command the condition IP = 1000H is tested after every STEP. If the 
sequence of STEPs reaches IP = 1000H as the next instruction, the loop will ter- 
minate. By contrast, consider this example: 


CS = SEG .START 
IP = OFF .START 
REPEAT 
UNTIL IP =1000H 
COUNT 10 
STEP 
ENDC 
ENDR 


In the second example, the condition IP = 1000H is tested after every ten STEPs. 
The loop exits only if IP = 1000H occurs at the end of some group of ten instruc- 
tions. If IP = 1000H occurs during one of the groups of ten STEPs, the loop does 
not terminate because that condition is changed by subsequent STEPs before the test 
can be made. 


If the command has more than one exit clause, each exit clause is tested when it is 
encountered. If the result at the moment of the test causes an exit, the loop ter- 
minates; otherwise, the loop proceeds to the next element. 


The loop exits only when the current test causes it, even though some other clause in 
the loop would cause an exit if it could be tested at that moment. Consider this 
(artificial) example: 


DEFINE .2Z =0 
CS =0 
IP =0 
REPEAT 
UNTILIP > 10H 
COUNT 5 
STEP 
ENDC 
PRINT —10 
WHILE .ZZ =0 
(22 = ZZ + 1 
ENDR 


Assume for this example that the code being emulated (with STEP) contains only 


two-byte instructions. Then, after the first time through the loop, IP = OAH (10T) 
and .ZZ = 1. On the second iteration, the test IP > 10H is FALSE when it is 
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encountered, so the STEP and PRINT commands are executed again. At this point, 
IP > 10H is TRUE but since it is not tested, no exit occurs. Instead, the condition 
.LZ = 0 is tested, found to be false, and the loop exits. 


Macro Commands 


A macro is a block of commands. When a block of commands is defined as a macro, 
it is stored on diskette so that it can be executed more than once without having to 
enter the commands each time. The macro commands described in this chapter 
allow you to perform the following functions: 


e Define a macro, specifying the macro name, the command block, and any 
formal parameters (points where text can be filled in at the time of the macro 
call). 


e Invoke (call) a macro by name, giving actual parameters to fill in the blank 
fields in the macro definition, to begin the execution of the command block. 


e Display the text of any macro as it was defined. 

e Enable or disable the display of the text of macros when they are invoked. 
e Display the names of all macros currently defined. 

e Remove one or more macros. 

e Save one or more macro definitions on an ISIS-II file. 


In addition, the off-line facility (INCLUDE command) allows you to enter macro © 


definitions from diskette files for use in the current test sequence. 


Defining and Invoking Macros | 


Each macro is defined once in the test session. The syntax of the DEFINE MACRO | 


(DEF MAC) command Is as follows: 


DEF MAC macro-name cr 
[command cr}... 
EM 


Once it is defined, you can INVOKE (call) a macro as often as desired. The syntax of a 
macro call is: 


:macro-name |actual-parameter-list | 


The macro definition command causes the macro name and block of commands to 
be stored in a table of macro definitions in a temporary ISIS-II file named 
MAC.TMP. (This file is removed by the ICE EXIT command). 


If you have a file on the ICE diskette named MAC.TMP, it will be lost 
when you enter the ICE-86A emulator. 


A macro-name must begin with an alphabet letter, or with one of the character ‘‘?”’ 
or ‘‘@’’. The characters after the first character can be alphabet letters, ‘‘?’’, ““@’’, 
or numeric digits. The macro name must not duplicate a previously-defined macro 
name. 


A macro definition may not appear within any other command (REPEAT, 
COUNT, IF, or another macro definition). The command block in the macro defini- 
tion can include any command except another DEF MAC command or a REMOVE 
MACRO command. 
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The macro name in the macro invocation must be the name of a previously-defined 
macro. The form of actual-parameter-list is discussed later in this chapter. 


Here is a simple macro definition: 


DEF MAC GOER 
REPEAT 
GO FROM .START TILL BRO 
END 
EM 


To invoke this macro and cause its command block to begin executing, enter the 
macro name preceded by a colon (:). For example: 


-GOER 


A macro definition can include calls to other macros, but a macro cannot call itself 
recursively. Any macros called from within a macro must have been defined when 
the calling macro is invoked. Macro calls can be nested; 1.e., one macro calls 
another, which calls another, and so on. The level of nesting is limited only by the 
memory space required to contain the macro expansions and “‘stack’’ the macro 
calls. 


When a macro js called as an outer level command, the following operations occur: 
e System default (SUFFIX) is saved in case a new default is set inside the macro. 


e The text of each actual parameter in the call is substituted for the corresponding 
formal parameter in the definition. 


e The expanded command block is executed if all commands are valid as 
expanded. | 7 


e When the last command has finished, the former system default is restored. 
e The macro exits. Control returns to the console (asterisk prompt). 


The next several sections provide details on these operations, including the treatment 
of nested macro calls. 


Local and Global Defaults 


The system default can have a ‘‘local’’ setting within a macro; this default is as 
follows: | 


Default Refers to: 
SUFFIX Default radix for console input. 


When a macro is called (or any compound command ts executed), the current 
‘‘slobal’’ setting of SUFFIX is saved so that it can be restored after the macro 
finishes executing its commands. The global default continues in effect within the 
macro unless and until a new (local) default is set with a SUFFIX command in the 
macro. Defaults other than SUFFIX are changed globally when they are set within a 
macro. 


When the macro finishes executing its command block, the previous SUFFIX 
default is restored. Thus, any SUFFIX default that is set within a macro has no 
effect after that macro has exited. 
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Here is an (artificial) example of a macro witha local default: 


DEF MAC SETO 
SUFFIX =H 
BYTE0TO10=0 

EM . 


Without the local SUFFIX command, the range of addresses to be set would depend 
on the global SUFFIX in effect when the macro SET0 is called. The global SUFFIX 
is restored after SETO exits. 


Formal and Actual Parameters 


A formal parameter marks a place in an ICE command where variable text can be 
‘*filled in’’ when the macro is called. A formal parameter can represent part of a 
token or a field of one or more tokens. A macro definition can contain up to ten for- 
mal parameters. A formal parameter has the form: 


%on 
where 7 1s a decimal digit, 0 to 9. 


Formal parameters can appear in the macro definition in any order, and each one 
can appear any number of times. In most cases, the formal parameters form a com- 
plete numeric sequence with %0 as the lowest numbered parameter (even if % is not 
the first parameter to appear). However, one or more parameters can be omitted 
from the sequence; the effect of omitting a formal parameter from the sequence Is to 
ignore the actual parameter in the call that corresponds to the omitted formal 
parameter. 


The macro call can contain as many actual parameters as desired. Enter multiple 
parameters as a list, with entries separated by commas. The first actual parameter in 
the list is substituted at all points that %0 appears in the macro definition; the 


second parameter substitutes for %1, and so on. 


An actual parameter can be ‘‘null’’, causing the ICE emulator to substitute a null 
for the formal parameter to which it corresponds. You can pass a null parameter to. 
a macro in two ways: 


e Enter no actual parameter between consecutive commas. 
e Omit one or more parameters from the end of the list. 


If too few actual parameters are entered, the ICE emulator supplies nulls for the 
extra formal parameters. If too many actual parameters are entered, the extra actual 
parameters are ignored. 


If any actual parameter contains a carriage return, acomma, or a single quote mark, 
the entire parameter must be enclosed in single quotes to identify it as a single actual 
parameter. In other words, parameters with these characters must be entered as 
strings. A single quote within a string is entered as (°‘). 


Here are some examples to demonstrate the use of formal and actual parameters: 


 M*OINTEGER %1 
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In the call to this macro, parameter %0 can become “‘S”’ or null. Parameter %1 can 
be any valid address or partition. Examples of calls to this macro: 


Macro call Expansion 


-MEM 8S, 1000H SINTEGER 1000H 
:>MEM, 1000H TO 100FH INTEGER 1000H TO 100FH 


Example 2: 


DEF MAC RPT 
REPEAT 
%0 
%1 
%o2 
%3 
%o4 
5 
%6 
%ot 
%8 
%9 
END 
EM 


Macro RPT can accept up to ten commands to be repeated. For example: 
“RPT GO TILL BRO, PRINT —1, REGISTERS, GO TILL BR1, PRINT —10 
If fewer than ten commands are given, as in the example above, the extra formal 


parameters are ignored (treated as nulls). This shows how to do REPEAT on one 
line with no end required. 


Example 3: 
DEF MAC BRS 
BR%0 = %1 
EM 


Use of macro BRS may require parameters entered as strings, since some ways to set 
breakpoints involve embedded commas. For example: 


‘BRS 0, 1000H EXECUTED 
This parameter is valid, but this one: 


BRS 0, FFH, .START LEN 100H 


results in the expansion: 


BRO = FFH 

To obtain the correct expansion, make the parameter a string: 
:-BRS 0, ‘FFH, .START LE N 100H" 

This results in the expansion: 


BRO = FFH, .START LEN 100H 
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Details on Macro Expansion > 


The syntax and semantics of commands in a macro block are ignored at the point of 
definition; they are not determined until invocation, and may be different on each 


invocation through the use of formal parameters. 


When a macro Is called, its definition is expanded by adding the text of any actual 
parameters in the call at the points indicated by formal parameters in the definition. 
If the expanded macro contains any calls to other macros, the text of any such 
macros is also expanded, forming in effect one overall block of commands. Expan- 
sion continues until the last EM is reached. If the expansion results in a set of 
complete, valid commands, the commands are executed. An error results if any 
command is incomplete or invalid after expansion. 


A macro invoked ina REPEAT, COUNT, or IF command is expanded immediately 
after the macro call command 1s entered. Thus, a macro called in a REPEAT or 
COUNT command is expanded only once, and a macro called in an IF command is 
expanded whether the condition in the IF or ORIF clause that contains the macro 
callis TRUE or FALSE. 


The ENABLE/DISABLE EXPANSION Command 


The ENABLE/DISABLE EXPANSION command controls the display of macros 
after they have been called. If EXPANSION is enabled, the fully-expanded macro is 
displayed when it 1s invoked. If EXPANSION is disabled, then no display occurs. A 
macro that is not displayed when it is invoked is termed a “‘silent’’ macro. 


EXPANSION is initally disabled. The state of EXPANSION does not affect the 
execution of macros, i.e., execution occurs if there are no syntax errors, regardless 
of whether EXPANSION is enabled or disabled. The syntax of the command 1s: 


ENABLE 
- DISABLE EXPANSION 
Examples: . 
*ENABLE EXPANSION 


*DISABLE EXPANSION 


Macro Table Commands 


The macro table contains the name and text of all macros currently defined. The text 
is stored as it is defined, and does not contain any expansions. 


~The DEFINE MACRO (DEF MAC) command adds the macro defined to the end of 


the table. The syntax of this command appears earlier in this chapter. The DEF 
MAC command may not appear with any other command. 


The REMOVE MACRO (REM MAC) command removes one or more macro 
definitions trom the table. The syntax of this command 1 1S: 


REM MAC [macro-name [ ,macro-name }...] 


If the list of macro-names is omitted, all macros are remuveds The REM MAC) com- 
mand may not appear within any other command. 
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The display macro command displays the name and definition of one or more 
macros from the macro table. The syntax is: 


MAC [macro-name |,macro-name }...| 


If the list of macro-names is omitted the definitions of all macros in the table are 
displayed. 


The macro directory command displays the names of all macros in the table. The 
syntax 1S: 


DIR MAC 


Here are some examples of these commands (assume that the table contains all the 
macro examples defined thus far in this chapter): 


Example |: 


*DIR MAC (command) 
GOER (display) 
SETO 

MEM 

RPT 

BRS 


Example 2: 


*MAC GOER (Command) 
DEF MAC GOER (display) 
REPEAT 

GO FROM .START TILL BRO 

END 

EM 


Example 3: 
REM MAC BRS (command) 
Example 4: 
*DIR MAC (Command) 
GOER | 
SETO 


MEM 
RPT 


Example 5: 


*DEF MAC NULL (command) 
*EM 


Example 6: 


*DIR MAC | (command) 
GOER (display) 
SETO 

MEM 

RPT 

NULL 
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Saving Macros 


~The PUT MACRO (PUT MAC) command causes one or more macro definitions to 


be copied trom table to an ISIS-II diskette file. The syntax iS: 
PUT [:drive: | filename MACRO [macro-name aiaes eane ie 


If any macro names are entered, those macro definitions are saved. If no list of 
macro names 1s given, all macros in the table are saved. The definitions } in the macro 
table are not affected by the operation. 


The file containing the saved macro can later be edited or brought into another ses- 
sion with the INCLUDE command, discussed later in this chapter. 


If the named file does not exist, it is created by the PUT command. If the file does 
exist on the diskette, the file is opened for input and the macros in the list are written 
on the file, destroying the previous contents of that file. 


Further Examples 


Here are a few more examples of macros. These macros simulate stack operations, 
cails, and returns in the ICE-86A emulator. 


A stack is an area of memory, indexed (addressed) by a register called the stack 
pointer (SP) and stack segment register (SS). The stack is used to save status 
information required for an orderly return from a procedure call. 


In the ICE-86A emulator, the stack is in mapped memory. The bottom (first 
available location) is the Aighest address in the stack area; the stack expands as 
needed into successively lower addresses. The stack pointer points to the address 
(word) at the top of the stack; this address contains the last item pushed on the 
stack. As each new word is pushed on the stack, SP is decremented to point to the 
new top address. Most of the values that need to be saved on the stack are 16-bit 
values. The high byte is stored in the address pointed to by (SS:SP — I), and the low 
byte is stored in the next lower address (equivalent to SS:SP — 2). 


The MCS-86 assembly language PUSH rp instruction sets SP to the next available 
word, then stores the content of the given register pair rp in adjacent addresses at 
that position. We can simulate this action with a macro, as follows: 


DEF MAC PUSH86 

SP =SP-2T ‘decrement SP 

WORD SS:SP =%0 slow byte in low address, high byte in 
EM ~high address. 


The formal parameter 0 lets us use PUSH86 to save any register pair or other 


16-bit value; for example: 


-PUSH86 IP ‘save instruction register 
~PUSH86 RAX ‘save RAX 
-PUSH86 RBX ;save RBX 
-PUSH86 RCX ssave RCX 


The complementary MCS-86 POP rp instruction copies the contents of the two top 
bytes back into the given register pair, then increments SP to the new top of the 
stack. A macro for this function is: 


DEF MAC POP86 
%0 = WORD SS:SP 
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SP =SP + 2T 
EM 


Here are some calls to POP86, corresponding to the PUSH86 calls given earlier: 


:POP86 RCX 
:POP86 RBX 
:POP86 RAX 
:POP86 IP 


Here are some macros that use PUSH86 and POP 86. 
1. Macro to ‘‘call’’ (short-call) a procedure: 


DEF MAC CALL86 
:PUSH86 IP 
GO FROM CS:%0 
EM 


This macro can be invoked with or without a halt condition: 


:CALL86 .PROC or 
‘-CALL86 .PROC TILL BRO 


2. Macro to “‘call’’ (long-call) a procedure: 


DEF MAC LCALL86 
:PUSH86 CS 
:PUSH86 IP 
GO FROM %0 

EM 


To invoke this macro: 


‘LCALL86 .PROC or 
‘LCALL86 .PROC TILL BR1 


3. Macro to “‘return’’ (short-return) from a procedure: 


DEF MAC RET86 
:POP86 IP 
GO %0 

EM 


To invoke this macro: 


-RET86 or 
-RET86 TILL BRO 


4. Macro to ‘‘return’’ (long-return) from a procedure: 


DEF MAC LRET86 
:POP86 IP 
‘POP86 CS 
| GO %0° 
EM 
To invoke this macro: 


:LRET86 or 
:-LRET86 TILL BRO 


5. Macro to single-step through user code, skipping over a specified procedure 
whenever that procedure is called from the user ePECEtams and printing the 
instruction just executed each time. : 


DEF MACRO SKIP 
REPEAT 
IF CS:IP = %0 
- :POP86 IP (short-called procedure) 
ENDIF 7 
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STEP 
PRINT —1 
ENDR 
EM 


DEF MACRO LSKIP (long-called procedure) 
REPEAT 
IF CS:IP = %0 
:POP86 IP 
:POP86 CS 
ENDIF 
STEP 
PRINT —1 
ENDR 
EM 


Suppose the user program contains a respective timer routine named DELAY that is 
called from several places in the program. The following macro invocation causes 
the ICE emulator to step through the program without emulating the timer routine: 


:SKIP .DELAY 


Off-line Facilities 


In addition to the compound and macro commands described above, the INCLUDE 
command allows you to access macro definitions stored in diskette files and to cause 
them to be executed from these files rather than the console. 


INCLUDE Command 


The INCLUDE command causes input to be taken from the file specified until the 
end-of-file, at which point input continues to be taken from the previous source, 
normally the console. 


The syntax of the INCLUDE command 1s: 


INCLUDE } [:drive:| filename 
-device: 


Nesting of INCLUDE command is permitted. For example: 


IP = .START 
REPEAT 
UNTIL IP = HALT 
INCLUDE PROGA.INC 
INCLUDE PROGB.INC 
ENDR 


The console (:CI:) may be given as the filename, in which cases control-Z must be 


—used as end-of-file. The files are echoed on the console. 


_ As macros can be complex and editing may be required on the macro definition, the 


INCLUDE command allows you to access offline macro definitions and to create 
online macros, which combine to form the macro suite for a particular debugging 
session. However, command lines may appear in the INCLUDE file, not just macro 


definitions. 
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Write Command 


The WRITE command writes one or more list elements to the console and to the list 
file at run time. : 


The syntax of the WRITE command 1s: 
WRITE /ist-element [,list-element| 
where 
list-element = string :: expr :: BOOL expr 
For example: 
WRITE SCTIME, ‘SECONDS SINCE LIGHT CHANGE’ 


would output a message showing the time in seconds (in CARS2) (see Chapter 3) 
since the traffic hight changed. 


This command writes the Jist-element (s) to the console all on the same line except 
when the nest-element will not fit into the remaining character space on the current 
line. In this event, a carriage return and a line feed will be inserted. If the /ist-element 
is a String, it will be displayed. If the /ist-element is an expr, the value of the expres- 
sion is displayed in the current base. A single character string is displayed as a string. 
When a single character string is used in an expression, its corresponding hexa- 
decimal value is used in evaluating the expression, and the value of the expression is 
displayed. 


If the /ist-element is BOOL expr, the ICE emulator displays the boolean value 


TRUE when the least-significant bit (LSB) of the result is 1, FALSE when the LSB is 
0; no spaces are provided either before or after the boolean value. 


The WRITE command can also be used to display values which are typed as REAL, 


~DREAL, or TREAL. 


For example: 


*“REA 2010 = 1.23E-5 


x 


* 


“WRITE REA 2010 
+ 1.23000000E-5 


APPENDIX A 
ICE-86A™ KEYWORDS 
AND THEIR ABBREVIATIONS 


ABSOLUTE ........... ABS HOLD iccesteincwee as HOL Rbene Gena eee RAL 
ACKNOWLEDGE ..... ACK HTIMER .............. HTI RA aciienacienle RAX 
A DDRG oie coat cts ADD {G) Se eee eae ne ICE RBs he vasunrian tac RBH 
PPC ohatscicweatcn ids aas AFL TE os Sacetentce tan Alay IF RBG ost te daeneles ee RBL 
PT te acaetiel danse erate easheiate ALL 12 a an ea Se een IFL MBX soles eee RBX 
AND iiss cacatens date ees AND INCLUDE ............. INC Ga: en ae ee RCH 
WSC ce odes heres ASC INFINITE.............. INF ROL ain jealous RCL 
NSM ogi cee octeeataeies ASM INPUT 3 ccd teacnese INP,1 RO eet a ah ak RCX 
BASE ost socrad ie darees BAS INSTRUCTION......... INS RDM wccecteseeseraeur RDH 
BHE «..4 ickawti cece BHE INTEGER.............. INT oa | CR ae geen ae nae ge RDL 
BOOL anéc.4cseeunedes BOO INTELLEC ............ INT RDX scacctiunaduedas RDX 
BP riche a aie nk esa hee BP INTERNAL............ INT RD Micioia dds saweit.ae RDY 
Bist s 6d eae ck BR ME 3 sacs bce neiacieeceaes IP READ .............. REA,R 
BRO scnaxdheneNeranuaek BRO TRS otic tare ane ern aed IR REA Lier costes nee REA 
BR1 ten wrmteemuasraeen BRI LENGTH.............. LEN REGISTER.......... REG,R 
BUFFERSIZE.......... BUF LANE sale casavecdaecns LIN REMOVE............. REM 
BUS sich erases otanak BUS Ce (eee ae er LIS REPEAT ............-. REP 
BY CEs tans Siena casa BYT LOAD 32.65 62a neeretues LOA RESET .............05- RES 
CAUSE 2 xconn ceeded CAU LOWER eictevicakstas LOW RE yn atseuna ena oweserteons RF 
CPL hits wade esters CFL MACRO...........25- MAC ROG Ti svesauensaeene ROGT 
CLOCK: couse teGke CLO MAP ic peel ancas te MAP RS lh 6d hte ddl weed RST 
CONDITIONALLY ....CON MARK ............--- MAR RWTIMEOUT......... RWT 
CONTINUOUS........ CON MASK oh nes eee MAS SAVE..........ceee eens SAV 
COUNT 2 iecetuinwns COU,C MATCH............-- MAT SEGMENT ............ SEG 
CS taints ee eas CS NENG che caasacususeete MN SELECTING........... SEL 
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APPENDIX B 


ERROR MESSAGES 


The following is a list of error messages. 


ERR 10:RSLTS BLK INACCESSIBLE 
A bus timeout was detected on an attempt to write the results block. 


ERR 11:XMIT BLK INACCESSIBLE 
A bus timeout was detected on an attempt to read the transmit block. 


ERR 16:DVC CD FORMAT ERROR 
The format byte of device code table was determined to be non-zero. 


ERR 17:DVC NOT IN DVC CD TABLE 
A device code corresponding to this ICE was not found in the device code table. 


ERR 21:COMMAND NOT ALLOWED NOW 
The command code in the parameter block cannot be processed at this time. 


NOTE 


This error can occur after pressing the ESC key if the buffer box is 
not properly grounded to the user system via the buffer box 
grounding cable. 


ERR 30:PGM MEMORY FAILURE 
Data read back from program memory did not agree with data written. 


ERR 31:DATA MEMORY FAILURE 
Data read back from data memory did not agree with data written. 


ERR 32:BREAKPOINT MEM FAILURE | 
Data read back from breakpoint memory did not agree with data written. 


ERR 33:MEMORY MAP FAILURE | 
Data read back from memory map did not agree with data written. 


ERR 34:CABLE FAILURE | 
Cable diagnostic program detected a failure in the cable. 


ERR 35:CONTROL CIRCUIT FAILURE 
Control diagnostic program detected a failure in the control circuitry (see 
note 1). | 


ERR 36:PAGE FAULT 7 
Not an error. Access was made to disk mapped memory and firmware doesn’t 
have page containing that location. 


ERR 37:INTELLEC MEMORY FAILURE 
Intellec memory does not verify when written to: it may be missing, non- 
writable, or bad memory. 


ERR 40:NO USER CLOCK 
In external clock mode, the CPU clock is not present. 


ERR 41:NO USER VCC 
In external clock mode, the user Vcc is not present. 


Error Messages 
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ERR 42:GUARDED ACCESS 
Access was made to a guarded memory or I/O location. 


ERR 43:PROCESSOR NOT RUNNING 
In external clock mode, the user ready signal is not present. 


ERR 48:READY TIMEOUT 


In external clock mode with timeout on ready selected, a command timeout | 


occurred. 


ERR 49:HOLD SEQUENCE ERROR 
A hold request was initiated and removed before hold ACK became active (see 
note 2). 


ERR 4A:HOLD TIMEOUT 
Cannot exit emulation or examine user memory because hold is inactive too 
long in the user system (see note 1). 


ERR 4B:RESET TIMEOUT 


Cannot exit emulation because reset is inactive (see note 1). 


ERR 80:SYNTAX ERROR 
The token flagged is not one that is allowed in the current context. 


# 


ERR 81:INVALID TOKEN 
The token flagged does not follow the rules for a well-formed token. 


ERR 82:NO SUCH LINE NUMBER 
_ The specified line number does not exist in the current module. 


ERR 83:INAPPROPRIATE NUMBER 
The value is not appropriate in the current context. 


ERR 84:PARTITION BOUNDS ERROR | 
The partition values entered in a command are not correct. Either the left part 
of the partition is greater than the right part, or the values of the partition 
extremes are out of range in the current context. 


ERR 85:ITEM ALREADY EXISTS 
The item entered in a define command is suena defined in the symbol table. 


ERR 86:ITEM DOES NOT EXIST 
The item printed on the preceding line does not resided in the symbol table. 


ERR 87:DUPLICATE CHANNEL 


The channel specified appears more than once in a channel list. 


ERR 88:MACRO PARAMETER ERROR 
Too many macro parameters or macro parameter too long. 


ERR 89:MISSING CR-LF IN FILE 
Include file doesn’t end in carriage-return line-feed. 


ERR 8A:FORMAT ALREADY EXISTS 
The format specified in a define command is already defined. 


ERR 8B:FORMAT DOES NOT EXIST 
The format specified has not been defined. 
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ERR 8C:COMPARE MODE NOT ACTIVE 
Find command was issued while compare trace mode was not active. 


ERR 8D:EMPTY TRACE BUFFER 
Trace buffer is uninitialized. 


ERR 8E: INVALID TRACE REFERENCE 
Trace reference made while trace buffer uninitialized. 


ERR 8F:NON-NULL STRING NEEDED 
A null string was used where a non-null string is required. 


ERR 90:MEMORY OVERFLOW | 
Memory requirements of all dynamic tables exceed the amount of memory 
available. 


ERR 91:STACK OVERFLOW 
The capacity of a statically allocated stack internal to the diagnostic program 
has been exceeded. 


ERR 92:COMMAND TOO LONG 
The capacity of the statically allocated intermediate code buffer has been 
exceeded. 


ERR 93:MODULE DOES NOT EXIST 
Module specified. does not exist in symbol table. 


ERR 94:NON-CHANGEABLE ITEM 
An attempt was made to change an item that may not be changed. 


ERR 95:INVALID OBJECT FILE 
File specified in a load command is not a valid object file. 


ERR 96:INVALID WITHIN ACTIVATE 
The command is not valid within an activate block. 


ERR 97:EXCESSIVE DATA 
The amount of data attempted to be inserted into a partition exceeded the size 
_ of the partition. 


ERR 98:MORE THAN 16 CHANNELS 
More than 16 channels specified in a channel list. 


ERR 99:EXCESSIVE ITERATED DATA 
The amount of data to be repeated throughout a range of memory exceeds the 
size of the buffer allocated to hold such data. 


ERR 9A:TOO MANY GROUPS 
Number of groups defined by user may not exceed 43. 


ERR 9B:TOO MANY CHANNELS 
Number of channels defined by user may not exceed 128. 


ERR 9C:UNSUITABLE EXECUTE FILE 
The file referenced in an execute command either contains code that is out-of- 
bounds for the execute command, or it is a main module. 


ERR 9D:LINE TOO LONG 
Command line was longer than 122 characters. 
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ERR 9E:HOST-ONLY COMMAND : 
The command issued is not allowed in an activation list. 


ERR 9F:PROCESS ALREADY ACTIVE 
Attempt made to activate a process that was already active. 


ERR A0:TOO MANY PARTITIONS 


Number of partitions or single breakpoints in a breakpoint register exceed max- 
imum permissible value. 


ERR A1:PARTITION CROSSES PAGE 
Breakpoint partition was not contained on a single page. 


ERR A2:ILLEGAL CLOCK VALUE 


Value specified for clock is not a permissible value. 


ERR A3:PROCESS ALREADY DORMANT 
Attempt made to suspend or terminate a dormant process. 


ERR A4:MACRO FILE FULL 
Macro file contains more than 64K characters. 


ERR A7:INAPPROPRIATE TYPE 
The type and value entered are inconsistent. Note: Error A7 displayed the string 
‘‘~POINTER VALUE REQUIRED’? in previous 8086 emulators. 


ERR A8:INTEGER VALUE REQUIRED 


A non-integer (i.e., pointer with non-zero base) value was used in a context that 
must use an integer. 


ERR A9:CANNOT REDECLARE MAP | 
An attempt was made to declare the disk map after it was already declared—the 
map must be reset in order to redeclare. 


ERR AA:MEMORY UNAVAILABLE 
The Intellec or disk memory explicitly given in a set-map command was never 
declared, or no explicit memory was given and there is no more Intellec, disk, or 
ICE memory available for ICE-86A to assign. 


ERR AC: TAKES TOO MANY BRS 
A match condition was given that requires more breakpoint registers than is 
allowed in the current context; either it required more than one register in a set 
breakpoint command, or required more than two registers in a till clause. 


ERR AD:DIFFERING BASES 
Two pointers with different bases were used in a context where they must have 
the same base, e.g., the lower and upper bounds of a partition. 


ERR AE:INVALID ‘‘AND”’ IN GO-REG 


The GO-register is ‘STILL BRO AND BR1’’ during a GO command, but either | 


(1) BRO or BR1 contains an execution-type match condition, or (2) BRO con- 
tains a data-time condition and BR1 contains an address-time condition. 


ERR B2:INVALID BASE 
The base used in the display breakpoint/tracepoint command Is out of range for 
part or all of the addresses in the register (e.g., “BRO BASE 0”? when BRO con- 
tains address 10000H). 


ERR B3:SYMBOL HAS NO TYPE | | 
A symbol being used in a typed memory reference (e.g., ‘*!X’’) has no type. 
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ERR B5:BLOCK IS EMPTY 


ERR BB:INVALID REAL NUMBER 
The syntax of the real number is incorrect. 


ERR BC:REAL NUMBER TOO LONG 


The real number had greater than 30 digits of mantissa without an exponent or 


greater than 25 digits of mantissa with an exponent. 


ERR BD:EXPONENT TOO LARGE 
The exponent generated for a real number was greater than the 4 digits allowed. 


ERR BE:MIXED REAL TYPES 
REAL, DREAL, and TREAL values were mixed illegally, e.g., REA 1000 = 
TRE 2000. 


ERR BF:REAL NUMBER OVERFLOW 
A real number that was not in the allowed range for reals was generated by the 
system or entered by the operator. The memory is not modified if this error 
occurs. 


WARN CO:UNSATISFIED EXTERNALS 
The program just loaded contains externals which were not satisfied at link 
time. The program was loaded correctly except for references to the unsatisfied 
externals. 


WARN C1:MAPPING OVER SYSTEM 
The user has modified the map so that part of his address space includes either 
the ISIS system or the GID software package. 


WARN C2:HARDWARE MISSING 
An attempt was made to initialize the device whose generic device code number 
is printed on the previous line but no device responded. A generic device code is 
the first of four consecutive device codes reserved for a specific type of device. 


WARN C3:MULTIPLE HARDWARE | 
An attempt was made to initialize the device whose device code number is 
printed on the previous line but more than one device responded. 


WARN C4:INVALID ‘SAND’ IN GR 
The GO-register is as described for ERR AE after GR, BRO or BRI was 
changed. 


WARN C5: INTELLEC MEM FAILURE | 
The Intellec memory whose physical segment number is on previous line does 
not verify when written to: it may be missing, non-writable, or bad memory. 


WARN C6:HARDWARE REINITIALIZED 
The hardware has been reinitialized, setting trace buffer to 0, i.e., no data is in 
the trace buffer. . | 


WARN C7:CLEARING TFL TO 0 


WARN C8:REINITIALIZING—FAULT 
The hardware is being reinitialized 


ERR E7:ILLEGAL FILENAME [4] 
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ERR E8:ILLEGAL DEVICE [5] 


Illegal or unrecognized device in filename. 


ERR E9:FILE OPEN FOR INPUT [6] 


Attempt to write to a file open for input. 
ERR EB:FILE OPEN FOR OUTPUT [8] 
ERR EC:DIRECTORY FULL [9] 

ERR EE:FILE ALREADY IN USE [11] 


ERR EF:FILE ALREADY OPEN [12] 
Attempted to open a file that was already open. 


ERR F0:NO SUCH FILE [13] 
The file specified does not exist. 


ERR F1:WRITE-PROTECTED FILE [14] 
Attempt to open a write-protected file for the purposes of writing data into it. 


ERR F3:CHECKSUM ERROR [16] 
A checksum error in a hex object file was encountered during loading. 


ERR F6:DISK FILE REQUIRED [19] 
Attempt to use a non-diskette file where a diskette file was required. 


ERR F9:ILLEGAL ACCESS [22] 
Attempt to open a read-only file for the purposes of storing data (i.e e., specify- 
ing :CI: as the list device) or a write-only file as a source of data (i.e., :LP: ina 
load command). 


ERR FA:NO FILENAME [23] 
No filename specified for a diskette file (i.e., no filename following :F1:). 


ERR FD:‘‘DONE”’ TIMED OUT 
The device whose device code number is printed on the preceding line was 
invoked but failed to return done within 5 seconds, 


ERR FE:‘‘ACKNOWLEDGE”’ TIMED OUT 


ICE-86A software attempted to pass information to ICE-86A hardware. but the - 


hardware did not respond by setting the acknowledge flag of the parameter 
block within 5 milliseconds. Specifically, ICE-86A firmware did not 
acknowledge receipt of the command in time. | 


ERR FF:NULL FILE EXTENSION [28] 
A file was specified so as to contain an extension but no extension was specified. 


Note 1. If error 35, 4A, or 4B occurs during Saulstion hardware will be reset as ifa 


RESET HARDWARE was executed. The emulation will not be recoverable 
as all registers will be set to the values they contained at the pesmnnis of 
emulation. Warning message C6 may be issued. 


Note 2. Error 49 will cause emulation to exit Pipe and warning message C6 will 
be issued. 


Note 3. Bracketed number following error message refers to the ISIS. error 
identified by this number. 
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Note 4. Error messages other than those documented in this list should not occur. If 
you encounter such an error, please report it to Intel Corporation, 3065 
Bowers Avenue, Santa Clara, CA 95051 MCSD, Customer Marketing, or 
your local Field Application Engineer. 
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ICE-86A™ COMMAND SYNTAX SUMMARY 


Command Summary 


debug session = [top-level command cr] ... 

top-level command = define macro command :: remove macro command :: command 
command = compound command :: simple command 

compound command = ifcommand :: repeat command :: count command :: write command 


simple command = display break/trace command :: set break/trace command :: 
go command :: step command :: go-register command :: 
enable/disable trace command :: trace command :: oldest command :: 
newest command :: print command :: move command :: clock command :: 
command signal timeout command :: enable/disable ready command :: 
display command :: change command :: define command :: 
display symbols command :: display lines command :: 
display modules command :: change symbol command :: 
remove symbols command :: set domain command :: 
reset domain command :: display map command :: 
declare map command :: set map command :: reset map command :: 
load command :: save command :: suffix command :: base command :: 
evaluate command :: list command :: exit command :: 
reset hardware command :: display macro command :: 
put macro command :: dir command :: include command 
enable/disable symbolically command :: enable/disable expansion command :: 
disassembly command :: define dasm command :: set/display rqgt command :: display 
bus command :: display cause command 


Expressions 


expr = pooléan term [or-op boolean term]... 

or-op =OR::XOR 

boolean term = boolean factor [AND boolean factor} ... 
boolean factor = [NOT] boolean primary 

boolean primary = arith expr (rel-op arith expr] 

rel-op =< PUSS PSN 

arith expr = memory reference :: port name :: address 
address = arith term (MASK arith term]... 

arith term = term |plus-op term]... 

plus-op = + ::- 

term = factor |mult-op factor) ... 

mult-op =* ::/:: MOD. 

factor = |plus-op | [segment-op| primary 

segment-op = primary : :: OFFSET :: SEGMENT 


primary = (expr) :: numeric constant :: source statement number :: string :: 
symbolic reference :: keyword reference 


symbolic reference = |module name | symbol {symbol} ... 
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_ module name = ..identifier 


symbol = .identifier 

source statement number = [module name] # primary-10: 

primary-10 = primary 

keyword reference = register name :: flag name :: pinname :: typed memory reference — 


partition = address |TO address] :: address LENGTH address 


Keyword Operators 


registername = RAL:: RAH:: RBL:: RBH :: RCL:: RCH :: RDL:: RDH:: RAX :: RBX =: RCX:: 


RDX :: SP :: BP :: SI: DI:: SS :: DS :: ES :: IP :: CAUSE :: OPCODE :: RF :: PIP :: 


TIMER :: HTIMER :: BUFFERSIZE :: UPPER :: LOWER 
flag name = AFL::CFL:: DFL::1FL:: OFL:: PFL:: SFL :: TFL :: ZFL 
pin name = RDY :: NMI:: TEST :: HOLD.:: RST :: MN ::1R 
port name = PORT address :: WPORT address 


memory reference = memory-designation address 


memory-designation = BYTE :: WORD :: SINTEGER :: INTEGER :: POINTER :: REAL :: DREAL :: 


TREAL 


typed memory reference = [!! identifier]! identifier |! identifier] ... 


Emulation Controls and Commands 

display break/trace command = break/ race reg Idispla y break/trace mode | 
set break/trace command = break/trace reg = match-cond 

break/trace reg = break reg :: trace reg 

break reg = BR:: BRO:: BR1 

trace reg = ONTRACE :: OFFTRACE 

display break/trace mode = ABSOLUTE :: BASE [expr] 

match-cond = execution match code :: non-execution match cond 
execution match cond = match value EXECUTED 


non-execution match cond = address match range [match status list] [data match range | 
[segment register usage] :: match status list [data match range | 
[segment register usage] :: data match range 
[segment register usage | :: segment register usage 


match value = address :: masked constant 
address match range = match range 


data match range = VALUE match range 


match partition = partition :: OBJECT memory reference :: OBJECT typed memory reference 
up/down = UP:: DOWN | | 3 

match status list = match status |, match status] ... 

match status = READ :: WRITTEN :: INPUT :: OUTPUT FETCHED :: HALT :: ACKNOWLEDGE 
segment register usage = USING segment register name | 


segment register name =SS::CS::DS:: ES 


~ go command = GO [FROM address | [go-register] 
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_ display map command = MAP [partition] 
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step command = STEP [FROM address | 

go-register command = GR [= go-register]| 

go-register = FOREVER:: TILL break 

break = break reg \|and/or break reg|:: match-cond [and/or match-cond | 
and/or = AND:: OR 


enable/disable trace command = ENABLE TRACE [CONDITIONALLY [NOW initia/ trace | ] :: 
DISABLE TRACE 


initial trace = ON :: OFF 

trace command = TRACE [= trace mode | 

trace mode = FRAME :: INSTRUCTION 

oldest command = OLDEST 

newest command = NEWEST 

print command = PRINT [ [p/us-op | primary-10] :: PRINT ALL 
move command = MOVE | [p/us-op | primary-10| 

clock command = CLOCK |= clock setting | 

clock setting = \NTERNAL :: EXTERNAL 

command signal timeout command = RWTIMEOUT [= new signa! | 
new signal = \NFINITE :: expr-10 [ERROR] :: expr-10 NOERROR © 
expr-10 = expr 

enable/disable ready command = ENABLE RDY :: DISABLE RDY 


Interrogation and Utility Commands 

display command = reference [, reference] mem or i/o partition :: ASM partition :: 
REGISTER :: FLAG :: PIN :: STACK expr :: BOOL expr 

mem or i/o =memory-designaltion :: PORT :: WRPORT 

change command = reference = expr ::mem or i/o partition = change exp |, change exp] ... 

change exp = mem or i/o partition :: expr :: string 

define command = DEFINE [module name] symbol = expr [OF type] 

displa y symbols command = SYMBOL :: symbolic reference 

display lines command = LINE :: source statement number 

display modules command = MODULE . 

change symbol command = symbolic reference = expr (OF type] 


remove symbols command = REMOVE symbolic reference [, symbolic reference] ...:: 
REMOVE SYMBOL :: 
REMOVE MODULE module name [, module name} ... 


type =memory desig 

set domain command = DOMAIN module name 
reset domain command = RESET DOMAIN 
cause command = CAUSE 


enable/disable symbolically command = ee } SYMBOLICALLY 
| | DISABLE | 
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declare map command = MAP DISK = file name :: MAP INTELLEC = partition [, partition) ... 
set map command = MAP partition = new memory map 
reset map command = RESET MAP 


new memory map = GUARDED :: USER [NOVERIFY] :: ICE [address] [NOVERIFY] :: 
INTELLEC [address] |NOVERIFY] :: DISK [address] [NOVERIFY] 


load command = LOAD path name | NOCODE | = 8 : 
| NOSYMBOL| ...[SELECTING module partition |,module partition)...] 
NOLINE 


module partition = { module name } 
module name TO module name 


NOSYMBO 
NOLINE 


save command = SAVE path name E ve code | 
L 
save code = NOCODE :: partition [, partition] ... 
suffix command = SUFFIX [= suffix] 
base command = BASE [= base] 
suffix =Y::0::Q::T::H 
base = suffix =: ASCII 
evaluate command = EVALUATE expr [SYMBOLICALLY] 


disassembly command = DEFINE DASM fe 
87 
EMULATOR 


list command = LIST path name 
exit command = EXIT 
reset hardware command = RESET HARDWARE 


set/display rqgt command = RQGT |= Fic | 
EMULATIONTIME 


display bus command =BUS 


cr =carriage-return line-feed 


IF Command 


if command = \F expr [THEN] cr true-list 
[ORIF expr [THEN] cr true-list] ... 
[ELSE cr false-list] 


true-list = [command cr} ... 
false-list = [command cr] ... 


end if= END 


Looping Commands 


repeat command = REPEAT cr /oop-list end-repeat 


end-repeat = END 


count command = COUNT expr-10 cr loop-list end-count 


expr-10 = expr 


end-count = END 
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loop-list = [loop element cr} ... 
loop element = command :: loop exit 


loop exit = WHILE EXPR :: UNTIL expr — 


Macro Definition Command 


define macro command = DEFINE MACRO macro name cr macro body EM 


macro name 2 identifier 


macro body = [command cr} ... 


Macro Invocation Command 


macro invocation command = macro name :: [actual parameter list} 
actual parameter list = actual parameter |, actual parameter |... 
actual parameter = |limited token] ...:: string 


limited token = any token exceptcr, String or ‘‘,’’ 


Remove Macro Command 


remove macro command = REMOVE MACRO [macro list] 


macro list = macro name |, macro name}... 


Display Macro Command 


display macro command = MACRO [macro list] 


Enable/Disable Expansion Command 


enable/disable expansion command = ae } EXPANSION 
DISABLE 


Put Macro Command 


put macro command = PUT file name MACRO [macro list] 


Directory Command 


dir command = DIR directory 


directory = MACRO 


Include Command 


include command = \NCLUDE file name 


Write Command 


write command = WRITE list element |, list element] ... 


list element = string :: expr :: BOOL expr 
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DC Characteristics of ICE-86A User Cable 


1. Output Low Voltages 


ADO0-AD15 


A16/S3-A19/S7, BHE/S7, RD, LOCK, QS0, QS1, SO, $1, 
$2, WR, M/IO, DT/R, DEN, ALE, INTA 


EMUL 
HLDA 

INITOUT 

MATCHO OR MATCH1 
RQ/GT | 


2. Output High Voltages 


ADO0-AD15 


A16/S3-A19/S7, BHE/S7, RD, LOCK, QS0, QS1, SO, $1, 
$2, WR, M/IO, DT/R, DEN, ALE, INTA 


EMUL 

HLDA 

INITOUT 

MATCHO OR MATCH1 
RQ/GT 


3. Input Low Voltages 


AD0-AD15 

BRKEXT 

NMI, CLK 

READY 

INTR, HOLD, TEST, RESET 
MN/MX (0.1 pf to GND) 


4. Input High Voltages 


AD0-AD15 

BRKEXT | 

NMI, CLK 

READY 

INTR, HOLD, TEST, RESET 
MN/MX 


Vo, (Max) 


0.4V 
0.5V 


0.4V 
0.5V 


—0.4V 
0.4V 
0.25V 
0.4V 
0.4V 


Vo. (Min) 
2.4V 
2.4V 


4.5V 
2.4V 
3.1V 
2.4V 
4.5V 


V,, (Max) 


0.8V 
0.4V 
0.8V 
0.8V 
0.8V 
0.8V 


V,4(Min) 


2.0V 
2.7V 
2.0V 
2.0V 
2.0V 
2.0V 


APPENDIX D 
ELECTRICAL AND PHYSICAL 
CHARACTERISTICS OF ICE-86A™ 


lo, (Max) 


12mA 
24mA 


8mA 
16MA 


16mA 
7mMA 
8mA 
16mA 
16mA 


lop (Max) 
—- 3mA 
—-2.6mMA 


250mA 
-3.0 mA 
2.6mMA 
—0.8mA 
250mA 


1, (Max) 


—0.2mA 
0.4mA 
—0.4mA 
—0.8mA 
—1.4mA 
—3.3mA 


1, (Max) 


80 pA 
20mA 
20 uA 
40 pA 
-0.4mA 
—1.1mA 


D-1 


Electrical and Physical Characteristics of the ICE-86A Emulator 


D-2 


Specifications 
ICE-86A Operating Environment 


Required Hardware: 
— Intellec Microcomputer Development System with: 
1. Three adjacent slots for ICE-86A 
2. 64K of Intellec Memory. If expansion memory is desired, no more than 32K may be 16K 
RAM boards. | 
System Console 
Intellec Diskette Operating System 
ICE-86A Module 


Required Software: 
System Monitor 
ISIS-II, Version 3.4 or subsequent 
ICE-86A Software 


Equipment Supplied 
Printed Circuit Boards (3) 
Interface Cable and Emulation Buffer Module 


Operator’s Manual 
ICE-86A Software 


Emulation Clock 
User system clock up to 5 MHz or 2 MHz internal clock in stand-alone mode. 


Physical Characteristics 
Printed Circuit Boards: 


Width 12.00 in (30.48 cm) 
Height 6.75 in (17.15 cm) 


Depth 0.50 in ( 1.27 cm) 
Packaged Weight — — 7 


Electrical Characteristics 


Voc = +5V +5% -1% 

loc = 16A maximum; 11A typical 

Vop = +12V +5% . 

lop = 120 mA maximum; 80 mA typical 
Ves = -10V +5% or -12V + 5% (optional) 
lap = 15mA maximum; 12 mA typical 


Environmental Characteristics 
Operating Temperature: 0° to 40°C 
Operating Humidity: Up to 95% relative humidity without condensation. 


NOTE 


The timing parameter TCL AZ has an actual transition of 85 ns for ICE-86A instead of 
80ns, as for the 8086 chip. 


The timing parameter TCL GH has an actual maximum value of 100 ns for ICE-86A 
instead of 85ns, as for the 8086 chip. 


All other timing parameters are as specified for the 8086 chip. 


HOLD/HOLDA Timing 


The diagrams below show the timing for the HOLD and HOLDA signals when the 
ICE-86A Module is in different modes of operation. During reset, byte/word/port 
commands and breakpoint loading, the worst case HOLDA response time is | 
millisecond. Breakpoints are loaded at the beginning of each emulation that 
specifies a new break condition. 


During an emulation break, up to | millisecond may elapse before the ICE Module 
response to a HOLD input with a HOLDA signal. 


At no time does the ICE-86A Module truncate a user HOLD in progress. 


ICE-86A 


ICE-86A Electrical and Physical Characteristics of the ICE-86A Emulator 


HOLD/HLDA TIMING 


1. ICE NOT IN EMULATION (INTERROGATION MODE): 


CPU CLOCK 
USER HOLD 


HLDA 


2. ICE IN EMULATION: 


«> > 


USER HOLD 


S S; So NUSER WAIT STATES 


HLDA 


3. DURING TIMES WHICH ICE REQUIRES EXCLUSIVE USE OF THE CPU TO EXECUTE ICE 
CORE OAGING? RESET HARDWARE, BYTE/WORD/PORT COMMANDS, AND BREAK- 


HLDA 
800 uSEC 
MAXIMUM 


162554-19 


00 00000000 
01 00000001 
02 00000010 
03 00000011 
04 00000100 
05 00000101 
06 00000110 
07 00000111 
08 00001000 
09 00001001 
0A 00001010 
0B 00001011 
0C 00001100 
OD 00001101 
OE 00001110 
OF 00001111 
10 00010000 
11 00010001 
12 00010010 
13 00010011 
14 00010100 
15 00010101 
16 00010110 
17 00010111 
18 00011000 
19 00011001 
1A 00011010 
1B 00011011 
1C 00011100 
1D 00011101 
1E 00011110 
1F 00011111 
20 00100000 
21 00100001 
22 00100010 
23 00100011 
24 00100100 
25 00100101 
26 00100110 
27 00100111 
28 00101000 
29 00101001 
2A 00101010 
2B 00101011 
2C 00101100 
2D 00101101 
2E 00101110 
2F 00101111 
30 00110000 


— 31 00110001 


32 00110010 
33 00110011 
34 00110100 
35 00110101 
36 00110110 
37 00110111 


— 38 00111000 


39 00111001 
3A 00111010 
3B 00111011 
3C 00111100 
3D 00111101 
3E 00111110 
3F 00111111 
40 01000000 
41 01000001 


MOD 
MOD 
MOD 
MOD 


MOD 
MOD 
MOD 
MOD 


MOD 
MOD 
MOD 
MOD 


MOD 
MOD 
MOD 
MOD 


MOD 
MOD 
MOD 
MOD 


MOD 


MOD 


MOD 
MOD 


MOD 
MOD 
MOD 
MOD 


MOD 
MOD 
MOD 
MOD 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 
REGR/M 
REGR/M 
REGR/M 


REGR/M 


REGR/M 
REGR/M 


REGR/M 


ADD EA,REG 
ADD EA,REG 
ADD REG,EA 
ADD REG,EA 
ADD AL,DATA8 
ADD AX,DATA16 
PUSH ES 

POP ES 

OR EA,REG 
OR EA,REG 
OR REG,EA 
OR REG,EA 
OR AL,DATA8 
OR AX,DATA16 
PUSH CS 

(not used) 

ADC EA,REG 
ADC EA,REG 
ADC REA,EA 
ADC REG,EA 
ADC AL,DATA8 
ADC AX,DATA16 
PUSH SS 

POP SS 

SBB EA,REG 
SBB EA,REG 
SBB REG,EA 
SBB REG,EA 
SBB AL,DATA8 
SBB AX,DATA16 
PUSH DS 

POP DS 

AND EA,REG 
AND EA,REG 
AND REG,EA 
AND REG,EA 
AND AL,DATA8 
AND AX,DATA16 
ES: 

DAA 

SUB EA,REG 
SUB EA,REG 
SUB REG,EA 
SUB REG,EA 
SUB AL,DATA8 
SUB AX,DATA16 
CS: 

DAS 

XOR EA,REG 
XOR EA,REG 
XOR REG,EA 
XOR REG,EA | 
XOR AL,DATA8 
XOR AX,DATA16 
SS: 

AAA 

CMP EA,REG 
CMP EA,REG 
CMP REG,EA 
CMP REG,EA 
CMP _AL,DATA8 
CMP AX,DATA16 
DS: 

AAS 

INC AX 


INC CX 


APPENDIX 
INSTRUCTIONS : 


a 
N 
HEXADECIMAL ORDER 


BYTE ADD (REG) TOEA 
WORD ADD (REG) TO EA 
BYTE ADD (EA) TO REG 
WORD ADD (EA) TO REG 
BYTE ADD DATA TO REG AL 
WORD ADD DATA TO REG AX 
PUSH (ES) ON STACK 

POP STACK TO REG ES 
BYTE OR (REG) TOEA 
WORD OR (REG) TO EA 
BYTE OR (EA) TO REG 
WORD OR (EA) TO REG 
BYTE OR DATA TO REG AL 
WORD OR DATA TO REG AX 
PUSH (CS) ON STACK 


BYTE ADD (REG) W/ CARRY TO EA 

WORD ADD (REG) W/ CARRY TO EA 

BYTE ADD (EA) W/ CARRY TO REG 

WORD ADD (EA) W/ CARRY TO REG 

BYTE ADD DATA W/CARRY TO REG AL 
WORD ADD DATA W! CARRY TO REG AX 
PUSH (SS) ON STACK 

POP STACK TO REG SS 

BYTE SUB (REG) W/ BORROW FROM EA 
WORD SUB (REG) W/ BORROW FROM EA 
BYTE SUB (EA) W/ BORROW FROM REG 
WORD SUB (EA) W/ BORROW FROM REG 
BYTE SUB DATA W/ BORROW FROM REG AL 
WORD SUB DATA W/ BORROW FROM REG AX 
PUSH (DS) ON STACK 

POP STACK TO REG DS 

BYTE AND (REG) TO EA 

WORD AND (REG) TO EA 

BYTE AND (EA) TO REG 

WORD AND (EA) TO REG 

BYTE AND DATA TO REG AL 

WORD AND DATA TO REG AX 

SEGMENT OVERIDE W/ SEGMENT REG ES 
DECIMAL ADJUST FOR ADD 

BYTE SUBTRACT (REG) FROM EA 

WORD SUBTRACT (REG) FROM EA 

BYTE SUBTRACT (EA) FROM REG 

WORD SUBTRACT (EA) FROM REG 

BYTE SUBTRACT DATA FROM REG AL 
WORD SUBTRACT DATA FROM REG AX 
SEGMENT OVERIDE W/ SEGMENT REG CS 
DECIMAL ADJUST FOR SUBTRACT 

BYTE XOR (REG) TO EA 

WORD XOR (REG) TO EA 

BYTE XOR (EA) FO REG 

WORD XOR (EA) TO REG 

BYTE XOR DATA TO REG AL 

WORD XOR DATA TO REG AX 

SEGMENT OVERIDE W/ SEGMENT REG SS 
ASCIl ADJUST FOR ADD 

BYTE COMPARE (EA) WITH (REG) 

WORD COMPARE (EA) WITH (REG) 

BYTE COMPARE (REG) WITH (EA) 

WORD COMPARE (REG) WITH (EA) 

BYTE COMPARE DATA WITH (AL) 

WORD COMPARE DATA WITH (AX) 
SEGMENT OVERIDE W/ SEGMENT REG DS 
ASCII ADJUST FOR SUBTRACT : 
INCREMENT (AX) 

INCREMENT (CX) 


Instructions in Hexadecimal Order 


E-2. 


42 01000010 
43 01000011 
44 01000100 
45 01000101 
46 01000110 
47 01000111 
48 01001000 
49 01001001 
4A 01001010 
4B 01001011 
4C 01001100 


4D 01001101 


4E 01001110 
4F 01001111 
50 01010000 
91 01010001 
92 01010010 
93 01010011 
94 01010100 
95 01010101 
96 01010110 
97 01010111 
98 01011000 
99 01011001 
SA 01011010 
5B 01011011 
9C 01011100 
9D 01011101 
SE 01011110 
OF 01011111 
60 01100000 
61 01100001 
62 01100010 
63 01100011 
64 01100100 
65 01100101 
66 01100110 
67 01100111 
68 01101000 
69 01101001 
6A 01101010 
6B 01101011 
6C 01101100 
6D 01101101 
6E 01101110 
6F 01101111 
70 01110000 
71 01110001 


72 01110010. 


73 01110011 
74 01110100 
75 01110101 
76 01110110 
77 01110111 
78 01111000 
79 01111001 
7A 01111010 
7B 01111011 
7C 01111100 
7D 01111101 
7E 01111110 
7F 019111111 
80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000. 
81 10000001 
81 10000001 


MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
MOD 000 
MOD 001 


R/M 
R/M 
R/M 


R/M - 


R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


INC 


POP 

(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
JO 

JNO 
JB/JNAE 
JNB/JAE 
JE/JZ 
JNE/JNZ 
JBE/JNA 
JNBE/JA 


ADD 


DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
DISP8 
EA,DATA8 
EA,DATA8 
EA,DATA8 
EA,DATA8 
EA,DATA8 
EA,DATA8 
EA,DATA8 
EA,DATA8 
EA,DATA16 


_EA,DATA16 


INCREMENT (DX) 
INCREMENT (BX) - 
INCREMENT (SP) 
INCREMENT (BP) 
INCREMENT (SI) 
INCREMENT (DI) 
DECREMENT (AX) 
DECREMENT (CX) 
DECREMENT (DX) 
DECREMENT (BX) 
DECREMENT (SP) 
DECREMENT (BP) 
DECREMENT (SI) 
DECREMENT (DI) 


_ PUSH (AX) ON STACK 


PUSH (CX) ON STACK 
PUSH (DX) ON STACK 
PUSH (BX) ON STACK 
PUSH (SP) ON STACK 
PUSH (BP) ON STACK 
PUSH (SI) ON STACK 
PUSH (Dl) ON STACK 
POP STACK TO REG AX 
POP STACK TO REG CX 
POP STACK TO REG DX 
POP STACK TO REG BX 
POP STACK TO REG SP 
POP STACK TO REG BP 
POP STACK TO REG SI 
POP STACK TO REG DI 


JUMP ON OVERFLOW 

JUMP ON NOT OVERFLOW 

JUMP ON BELOW/NOT ABOVE OR EQUAL 
JUMP ON NOT BELOW/ABOVE OR EQUAL 
JUMP ON EQUAL/ZERO : 
JUMP ON NOT EQUAL/NOT ZERO 

JUMP ON BELOW OR EQUAL/NOT ABOVE 
JUMP ON NOT BELOW OR EQUAL/ABOVE 
JUMP ON SIGN 

JUMP ON NOT SIGN 

JUMP ON PARITY/PARITY EVEN 

JUMP ON NOT PARITY/PARITY ODD 

JUMP ON LESS/NOT GREATER OR EQUAL 
JUMP ON NOT LESS/GREATER OR EQUAL 
JUMP ON LESS OR EQUAL/NOT GREATER 
JUMP ON NOT LESS OR EQUAL/GREATER 
BYTE ADD DATA TO EA 

BYTE OR DATATOEA 

BYTE ADD DATA W/ CARRY TO EA 

BYTE SUB DATA W/ BORROW FROM EA 
BYTE AND DATA TO EA 


. BYTE SUBTRACT DATA FROM EA 


BYTE XOR DATATOEA 

BYTE COMPARE DATA WITH (EA) 
WORD ADD DATA TO EA 

WORD OR DATA TO EA 


 ICE-86A 


ICE-86A 


81 10000001 
81 10000001 
85 10000001 
81 10000001 
81 10000001 
81 10000001 
82 10000010 
82 10000010 
82 10000010 
82 10000010 
82 10000010 
82 10000010 
82 10000010 
82 10000010 
83 10000011 
83 10000011 
83 10000011 
83 10000011 
83 10000011 
83 10000011 
83 10000011 


~ 83 10000011 


84 10000100 
85 10000101 
86 10000110 
87 10000111 
88 10001000 
89 10001001 
8A 10001010 
8B 10001011 
8C 10001100 
&C 10001100 
8D 10001101 
8E 10001110 
8E 10001110 
8F 10001111 
8F 10001111 
8F 10001111 
8F 10001111 
8F 10001111 
8F 10001111 
8F 10001111 
8F 10001111 
90 10010000 


91 10010001 


92 10010010 
93 10010011 
94 10010100 
95 10010101 
96 10010110 
97 10010111 
98 10011000 
99 10011001 
9A 10011010 
9B 10011011 
9C 10011100 
9D 10011101 
9E 10011110 
QF 10011111 
AO 10100000 
A1 10100001 
A2 10100010 
A3 10100011 
A4 10100100 
AS 10100101 
A6 10100110 
A7 10100111 
A8 10101000 
A9 10101001 
AA10101010 
AB10101011 
AC10101100 


MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 


R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


MOD REGR/M 
MOD REGR/M 
MOD REGR/M 
MOD REGR/M 
MOD REGR/M 
MOD REGR/M 
MOD REGR/M 
MOD REGR/M 
MOD 0SR R/M 
MOD 1-- R/M 
MOD REGR/M 
MOD 0SR R/M 


MOD -- 
MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 


‘MOD 111 


R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


~* MOV 


ADC 
SBB 
AND 
SUB 
XOR 
CMP 
ADD 
(not used) 


. ADC 


SBB 


(not used) 


SUB 


(not used) 


CMP 
ADD 
(not used) 
ADC 
SBB 


(not used) 


SUB 
(not used) 
CMP 
TEST 
TEST 
XCHG 
XCHG 
MOV 
MOV 
MOV 
MOV 
MOV 

(not used) 
LEA 

MOV 

(not used) 
POP 

(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
XCHG 
XCHG 
XCHG 
XCHG 
XCHG 
XCHG 
XCHG 
XCHG 
CBW 
CWD 
CALL 
WAIT 
PUSHF 
POPF 
SAHF 
LAHF 
MOV 
MOV 


MOV 
MOVS 
MOVS 
CMPS 
CMPS 
TEST 
TEST 
STOS 
STOS 
LODS 


EA,DATA16 
EA,DATA16 
EA,DATA16 
EA,DATA16 
EA,DATA16 
EA,DATA16 
EA,DATA8 


EA,DATA8 
EA,DATA8 


EA,DATA8 


EA,DATA8 
EA,DATA8 


EA,DATA8 
EA,DATA8 


EA,DATA8 


EA,DATA8 
EA,REG 
EA,REG 
REG,EA 
REG,EA 
EA,REG 
EA,REG 


-REG,EA 


REG,EA 
EA,SR 


REG,EA 
SR,EA 


EA 


AX,AX 
AX,CX 
AX,DX 
AX,BX 
AX,SP 
AX,BP 
AX,SI 

AX,DI 


DISP16,SEG16 


AL,ADDR16 


- AX,ADDR16 


ADDR16,AL 
ADDR16,AX 
DST8SRC8 
DST16,SRC16 
SIPTR,DIPTR 
SIPTR,DIPTR 
AL,DATA8 
AX,DATA16 
DST8 

DST16 

SRC8 


Instructions in Hexadecimal Order 


WORD ADD DATA W/ CARRY TO EA 
WORD SUB DATA W/ BORROW FROM EA 
WORD AND DATATOEA 

WORD SUBTRACT DATA FROM EA 
WORD XOR DATA TO EA 

WORD COMPARE DATA WITH (EA) 

BYTE ADD DATATOEA 


BYTE ADD DATA W/ CARRY TO EA 
BYTE SUB DATA W/ BORROW FROM EA 


BYTE SUBTRACT DATA FROM EA 


BYTE COMPARE DATA WITH (EA) 
WORD ADD DATA TOEA 


WORD ADD DATA W/ CARRY TO EA 
WORD SUB DATA W/ BORROW FROM EA 


WORD SUBTRACT DATA FROM EA 


WORD COMPARE DATA WITH (EA) 
BYTE TEST (EA) WITH (REG) | 
WORD TEST (EA) WITH (REG) 

BYTE EXCHANGE (REG) WITH (EA) 
WORD EXCHANGE (REG) WITH (EA) 
BYTE MOVE (REG) TOEA 

WORD MOVE (REG) TO EA 

BYTE MOVE (EA) TO REG 

WORD MOVE (EA) TO REG 

WORD MOVE (SEGMENT REG SR) TO EA 


LOAD EFFECTIVE ADDRESS OF EA TO REG 
WORD MOVE (EA) TO SEGMENT REG SR 


POP STACK TOEA 


EXCHANGE (AX) WITH (AX), (NOP) 
EXCHANGE (AX) WITH (CX) 
EXCHANGE (AX) WITH (DX) 
EXCHANGE (AX) WITH (BX) 
EXCHANGE (AX) WITH (SP) 
EXCHANGE (AX) WITH (BP) 
EXCHANGE (AX) WITH (SI) 
EXCHANGE (AX) WITH (Dl) 

BYTE CONVERT (AL) TO WORD (AX) 
WORD CONVERT (AX) TO DOUBLE WORD 
DIRECT INTER SEGMENT CALL 
WAIT FOR TEST SIGNAL 

PUSH FLAGS ON STACK 

POP STACK TO FLAGS 

STORE (AH) INTO FLAGS 

LOAD REG AH WITH FLAGS 

BYTE MOVE (ADDR) TO REG AL 
WORD MOVE (ADDR) TO REG AX 
BYTE MOVE (AL) TO ADDR 

WORD MOVE (AX) TO ADDR 

BYTE MOVE, STRING OP 

WORD MOVE, STRING OP 
COMPARE BYTE, STRING OP 
COMPARE WORD, STRING OP 
BYTE TEST (AL) WITH DATA 
WORD TEST (AX) WITH DATA 
BYTE STORE, STRING OP 

WORD STORE, STRING OP 

BYTE LOAD, STRING OP 


E-3 


Instructions in Hexadecimal Order 


E-4 


AD10101101 
AE 10101110 
AF 10101111 


BO 10110000 
B1 10110001 


B2 10110010 
B3 10110011 
B4 10110100 
B5 10110101 
B6 10110110 
B7 10110111 
B8 10111000 
B9 10111001 
BA10111010 
BB10111011 
BC10111100 
BD10111101 
BE 10111110 
BF 10111111 
CO 11000000 
C1 11000001 
C2 11000010 
C3 11000011 
C4 11000100 
C5 11000101 
C6 11000110 
C6 11000110 
C6 11000110 
C6 11000110 
C6 11000110 
C6 11000110 
C6 11000110 
C6 11000110 
C7 11000111 
C7 11000111 
C7 11000111 
C7 11000111 
C7 11000111 
C7 11000111 


_ 0711000111 


C7 11000111 
C8 11001000 
C9 11001001 
CA11001010 
CB11001011 
CC11001100 
CD11001101 
CE 11001110 
CF 11001111 
DO 11010000 
DO 11010000 
D0 11010000 


DO 11010000 


DO 11010000 
DO 11010000 
DO 11010000 
DO 11010000 
D1 11010001 
Di 11010001 
D1 11010001 
D1 11010001 


-D1.11010001 


D1 11010001 


D1 11010001 


D1 11010001 
D2 11010010 
D2 11010010 
D2 11010010 
D2 11010010 
D2 11010010 


D2 11010010 


D2 11010010 


D2 11010010 


MOD REGR/M 
MOD REGR/M 


MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 


MOD 000 
MOD 001 


MOD 010. 


MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
MQD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 


MOD 111 


MOD 000 
MOD 001 
MOD 010 
MOD 011 


MOD 100 


MOD 101 
MOD 110 
MOD 111 


R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


R/M 
R/M 
R/M 
R/M 


R/M © 


R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


-R/M- 


R/M 


R/M 


R/M 


R/M 


R/M 
R/M 
R/M 
R/M 
R/M 


R/M 


R/M 


LODS 


~ SCAS © 


SCAS 
MOV 
MOV 
MOV 


- MOV 


MOV 


MOV 


MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 

(not used) 
(not used) 
RET 

RET 

LES 

LDS 

MOV 

(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
MOV 

(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
(not used) 
RET 

RET 

INT 

INT 

INTO 
IRET 
ROL 

ROR 

RCL 

RCR 


~SHL 


SHR 
(not used) 
SAR 
ROL 
ROR 
RCL 


‘ROR 


SHL 


- SHR 
(not used) 
~- SAR 


ROL 
ROR. 
RCL 
RCR 
SHL 


SHR 


SRC16 
DIPTR8 
DIPTR16 


AL,DATAS . 
 CL,DATA8 


DL,DATA8 
BL,DATA8 
AH,DATA8 
CH,DATA8 
DH,DATA8 
BH,DATA8 
AX,DATA16 
CX,DATA16 
DX,DATA16 
BX,DATA16 
SP,DATA16 
BP,DATA16 
SI,DATA16 
DI,DATA16 


DATA16 
REG,EA 


REG,EA 
EA,DATA8 


EA,DATA16 


(notused) — 


SAR 


EA,CL 


ICE-86A 


WORD LOAD, STRING OP 
BYTE SCAN, STRING OP 


WORD SCAN, STRING OP 


- BYTE MOVE DATA TO REG AL 


BYTE MOVE DATA TO REG CL 


- BYTE MOVE DATA TO REG DL 


BYTE MOVE DATA TO REG BL 
BYTE MOVE DATA TO REG AH 
BYTE MOVE DATA TO REG CH 
BYTE MOVE DATA TO REG DH | 
BYTE MOVE DATA TO REG BH . 
WORD MOVE DATA TO REG AX 
WORD MOVE DATA TO REG CX 
WORD MOVE DATA TO REG Dx 
WORD MOVE DATA TO REG BX 
WORD MOVE DATA TO REG SP 
WORD MOVE DATA TO REG BP. 
WORD MOVE DATA TO REG SI 
WORD MOVE DATA TO REG DI 


INTRA SEGMENT RETURN, ADD DATA TO REG SP 


INTRA SEGMENT RETURN 

WORD LOAD REG AND SEGMENT REG ES 
WORD LOAD REG AND SEGMENT REG DS 
BYTE MOVE DATATOEA 


WORD MOVE DATA TO EA 


INTER SEGMENT RETURN, ADD DATA TO REG SP 
INTER SEGMENT RETURN 

TYPE 3 INTERRUPT 

TYPED INTERRUPT 

INTERRUPT ON OVERFLOW 

RETURN FROM INTERRUPT 

BYTE ROTATE EALEFT 1 BIT 

BYTE ROTATE EA RIGHT 1 BIT 

BYTE ROTATE EALEFT THRU CARRY 1 BIT 
BYTE ROTATE EA RIGHT THRU CARRY 1 BIT 
BYTE SHIFTEALEFT1 BIT ~ 

BYTE SHIFT EA RIGHT 1 BIT 


BYTE SHIFT SIGNED EA RIGHT 1 BIT 

WORD ROTATEEALEFT1BIT | 

WORD ROTATE EA RIGHT 1 BIT i 
WORD ROTATE EALEFT THRU CARRY 1 BIT 
WORD ROTATE EA RIGHT THRU CARRY 1 ov 
WORD SHIFT EA LEFT 1 BIT 

WORD SHIFT EA RIGHT 1 BIT 


- WORD SHIFT SIGNED EA RIGHT 1 BIT 


BYTE ROTATE EA LEFT (CL) BITS 

BYTE ROTATE EA RIGHT (CL) BITS 

BYTE ROTATE EA LEFT THRU CARRY (CL) BITS 
BYTE ROTATE EA RIGHT THRU CARRY (CL) BITS 
BYTE SHIFTEALEFT(CL) BITS | 

BYTE SHIFT EA RIGHT (CL) BITS 


BYTE SHIFT SIGNED EA RIGHT (CL) BITS - 


_ ICE-86A 


D3 11010011 
D3 11010011 
D3 11010011 
D3 11010011 
D3 11010011 
D3 11010011 
D3 11010011 
D3 11010011 
D4 11010100 
D5 11010101 
D6 11010110 
D7 11010111 
D8 11011— 

EO 11100000 
E1 11100001 
E2 11100010 
E3 11100011 
E4 11100100 
E5 11100101 
E6 11100110 
E7 11100111 
E8 11101000 
E9 11101001 


EA11101010 


EB11101010 
EC 11101010 
ED 11101010 
EE 11101010 
EF 11101010 
FO 11110000 
F1 11110001 
F2 11110010 
F3 11110011 


F4 11110100 


F5 11110101 
F6 11110110 
F6 11110110 
F6 11110110 
F6 11110110 
FG 11110110 
F6 11110110 
F6 11110110 
F6 11110110 
F7 11110111 


~ FZ 11110111 


F7 11110111 
F7 11110111 
F7 11110111 
F7 11110111 
F7 11110111 
F7 11110111 
F8 11111000 
FO 11111001 
FA 11111010 
FB 11111011 
FC 11111100 
FD 11111101 
FE 11111110 
FE 11111110 
FE 11111110 
FE 11111110 
FE 11111110 
FE 11111110 
FE 11111110 
FE 11111110 
FF 14111111 
FF 14111111 
FF 41111111 
FF 11111111 
FF 11111111 


FR 411114111 


FR 11111111 
FF 11114111 


MOD. 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
00001010 
00001010 


MOD --- 


MOD 000 
MOD 001 


MOD 010 


MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 
MOD 000 
MOD 001 
MOD 010 
MOD 011 
MOD 100 
MOD 101 
MOD 110 
MOD 111 


MOD 110 
MOD 111 


R/M 
R/M 
R/M 
R/iM 
R/M 
R/M 
R/M 
R/M 


R/M 


R/M 


R/M 
R/M 


R/M 


R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


R/M 
R/M 
R/M 
R/M 
R/M 
RIM 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 
R/M 


ROL EA,CL 
ROR EA,CL 
RCL EA,CL 
RCR EA,CL 
SHL EA,CL 
SHR EA,CL 
(not used) 

SAR EA,CL 
AAM 

ADD 

(not used) 

XLAT TABLE 
ESC EA 
LOOPNZ/LOOPNE DISP8 
LOOPZ/LOOPE  DISP8 
LOOP DISP8 
JCXZ DISP8 

IN AL,PORT 
IN AX,PORT 
OUT PORT,AL 
OUT PORT ,AX 
CALL DISP16 
JMP DISP16 
JMP DISP16,SEG16 
JMP DISP8 

IN AL,DX 

IN AX,DX 
OUT DX,AL 
OUT DX,AX 
LOCK 

(not used) 

REPNZ 

REPN 

HLT 

CMC 

TEST EA,DATA8& 
(not used) 

NOT EA 

NEG EA 

MUL EA 

IMUL EA 

DIV EA 

IDIV EA 

TEST EA,DATA16 
(not used) 

NOT EA 

NEG EA 

MUL EA 

IMUL EA 

DIV EA 

IDIV EA 

CLC 

STC 

CLI 

STI 

CLD 

STD 

INC EA 

DEC EA 

(not used) 

(not used) 

(not used) 

(not used) 

(not used) 

(not used) 

INC EA 

DEC EA 

CALL EA 

CALL EA 

JMP EA 

JMP EA 

PUSH EA 

(not used) — 


Instructions in Hexadecimal Order 


WORD ROTATE EA LEFT (CL) BITS 

WORD ROTATE EA RIGHT (CL) BITS 

WORD ROTATE EALEFT THRU CARRY (CL) BITS 
WORD ROTATE EA RIGHT THRU CARRY (CL) BITS 
WORD SHIFT EA LEFT (CL) BITS 

WORD SHIFT EA RIGHT (CL) BITS 


WORD SHIFT SIGNED EA RIGHT (CL) BITS 
ASCIl ADJUST FOR MULTIPLY 
ASCIil ADJUST FOR DIVIDE 


TRANSLATE USING (BX) 

ESCAPE TO EXTERNAL DEVICE 

LOOP (CX) TIMES WHILE NOT ZERO/NOT EQUAL 
LOOP (CX) TIMES WHILE ZERO/EQUAL 
LOOP (CX) TIMES 

JUMP ON (CX)=0 

BYTE INPUT FROM PORT TO REG AL 
WORD INPUT FROM PORT TO REG AX 
BYTE OUTPUT (AL) TO PORT 

WORD OUTPUT (AX) TO PORT 

DIRECT INTRA SEGMENT CALL 

DIRECT INTRA SEGMENT JUMP 

DIRECT INTER SEGMENT JUMP 

DIRECT INTRA SEGMENT JUMP 

BYTE INPUT FROM PORT (DX) TO REG AL 
WORD INPUT FROM PORT (DX) TO REG AX 
BYTE OUTPUT (AL) TO PORT (DX) 

WORD OUTPUT (AX) TO PORT (DX) 

BUS LOCK PREFIX 


REPEAT WHILE (CX)#0 AND (ZF)= 
REPEAT WHILE (CX)#0 AND (ZF)= 
HALT 7 

COMPLEMENT CARRY FLAG 
BYTE TEST (EA) WITH DATA 


0 
1 


BYTE INVERT EA 

BYTE NEGATE EA 

BYTE MULTIPLY BY (EA), UNSIGNED 
BYTE MULTIPLY BY (EA), SIGNED 
BYTE DIVIDE BY (EA), UNSIGNED 
BYTE DIVIDE BY (EA), SIGNED 
WORD TEST (EA) WITH DATA 


WORD INVERT EA 

WORD NEGATE EA 

WORD MULTIPLY BY (EA), UNSIGNED 
WORD MULTIPLY BY (EA), SIGNED 
WORD DIVIDE BY (EA), UNSIGNED 
WORD DIVIDE BY (EA), SIGNED 
CLEAR CARRY FLAG 

SET CARRY FLAG 

CLEAR INTERRUPT FLAG 

SET INTERRUPT FLAG 

CLEAR DIRECTION FLAG 

SET DIRECTION FLAG 

BYTE INCREMENT EA 

BYTE DECREMENT EA 


WORD INCREMENT EA 
WORD DECREMENT EA 
INDIRECT INTRA SEGMENT CALL 
INDIRECT INTER SEGMENT CALL 
INDIRECT INTRA SEGMENT JUMP 
INDIRECT INTER SEGMENT JUMP 


PUSH (EA) ON STACK 
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Instructions in Hexadecimal Order 
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REG IS ASSIGNED ACCORDING TO THE FOLLOWING TABLE: 


16-BIT(W=1)  8-BIT(W=0) | SEGMENT REG 


000 AX 000 AL 00 
001 CX 001 CL 01 
010 DX 010 DL 10 
011 BX 011 BL 11 
100 SP 100 AH 
101 BP 101 CH 
110 Si 110 DH 
111. Di 111. BH 


EA IS COMPUTED AS FOLLOWS: (DISP8 SIGN EXTENDED TO 16 BITS) 
00 000 


00 001 
00 010 


00 «(011 


00 100 
00 101 
00 110 
00 111 
01 000 
01 001 
01 010 
01 O11 
01 100 
01 101 
01 110 
01 111 
10 000 
10 001 
10 010 
10 O11 
10 100 
10 101 
10 110 
10 111 
11. 000 
11 001 
11 010 
11 (011 
11 100 
11 101 
11 110 
11 (111 


FLAGS 


(BX) +(Sl) 
(BX) + (Dl) 

(BP) +(Sl) 
(BP) + (Dl) 

(SI) 

(DI) 

DISP16 (DIRECT ADDRESS) 
(BX) 

(BX) + (SI) + DISP8 
(BX) + (Dl) + DISP8 
(BP) + (Si) + DISP8 
(BP) + (Dl) + DISP8 
(SI) + DISP8 

(DI) + DISP8 

(BP) + DISP8 
(BX) + DISP8 
(BX) + (SI) + DISP16 
(BX) + (Dl) + DISP16 
(BP) + (SI) + DISP16 
(BP) + (Dl) + DISP16 
(SI) + DISP16 

(DI) + DISP16 
(BP) + DISP16 
(BX) + DISP16 

REG AX / AL 

REG CX/CL 

REG DX / DL 

REG BX / BL 

REG SP / AH 

REG BP / CH 

REG SI / DH 

REG DI / BH 


REGISTER CONTAINS: 


| X:X:X:X:(OF):(DF):(IF):(TF):(SF):(ZF):X:(AF):X:(PF):X:(CF) 


ICE-86A 


ICE-86A Instructions in Hexadecimal Order 


8086 INSTRUCTION SET MATRIX 


| me 
r 
(—] 


. LO 
Hi 0 2 6 Hi 8 # D E 
0 ADD ADD ADD aa ani sa Bou rp 0 OR PUSH 
b.f.c/m | war/m | batar/m | w.ts/m b. ia w.ia b.f.r/m ae ae in cs 
I ADC ADC ADC ADC ADC ADC msi re | SBB SBB SBB a a a 
bfr/m | woac/m | bote/m | owote/m b.i wl b.f.r/m | wofe/m | betr/m | wotie/m 
2 AND AND AND AND sc 2 SUB SUB SUB U8 a 
b.f.r/m | w.tc/m | baAar/m | owetar/m b.f.r/m { wc/m 7 bot /m | wote/m 
3 | XOR XOR XOR XOR ce 3 CMP CMP CMP CMP AAS 
b.f.r/m fw.tie/m ) botr/m | ow.ti/m b.f.r/m | wof.r/m | b.t.r/m | w.te/m 
4 INC a a Ave INC INC nc oa 4 ee i ne : 
AX SP BP | 
5 PUSH rsh PUSH rsh 5 re rT re a 508 
AX BP a 
SE ne et i a 
qT iH JNE/ JBE/ cir 7 JP/ JL/ JLE/ ‘a 
JNZ JNA JPE JNGE JNG JG 
8 | Immed sisi TEST XCHG a 8 MOV MOV MOV MOV MOV POP 
b.r/m : b.r/m | w.r/m b.r/m w.r/m b.f.r/m | wfr/m | bitac/m | w.tcim | sryfr/m sr,t.r/m | oc/m 
. se St ae [ie [oe er [a 
A ov A bie oie 
maa wovs | owes | owes S108 Loos | 00s Scns 
8 MOV MOV MOV B Mov mir MOV MOV MOV MOV 
- i—~CL i] +— DL} 1i— BL i - DH | 1 — BH i—-AX{i— CX |i —DX] t — BX | i — SP 1 + Ol 
C RET. Ae MOV C RET. cn INT | 
b.v 7 
: om | 0 ae jd a EE 
Sl, d VW 
F F Grp 2 
w.r/m 


b = byte operation m = memory 

d = direct r/m = EA is second byte 
f = from CPU reg Si = short intrasegment 
i = immediate sr = segment register 

ia = immed. to accum. t = to CPU reg 

id = indirect v = variable 

is = immed. byte, sign ext. w = word operation 

| = long ie. interseqgment Z = zero 
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APPENDIX F 


iSBC 86/12" AND iSBC 86/12A™ FIX 


ICE-86A may produce an error in reading a single byte when ICE-86A is used with 
an iSBC 86/12 or iSBC 86/12A Single Board Computer. A spurious error can occur 
in a data byte read from an odd memory location in the iSBC 86/12 or iSBC 
86/12A. The error is caused by a change in the even byte signals while the read signal 


is active at the interface between ICE-86A and iSBC 86/12. As a result the lower 


byte and upper byte data lines may cross-couple in the ICE-86A user cable during a 
single byte read operation. A similar error condition exists for I/O operations. 


The noise interference during the reading of odd memory locations can be 
eliminated by locating 10K ohm resistors on the iSBC 86/12 or the iSBC 86/12A. 
These resistors guarantee that the even byte data lines will be in a stable logic state. 
To eliminate the read interference, it is recommended that a 10K ohm resistor pack 
be mounted to pins 1 through 8 of a 20 pin I.C. test clip with pin 20 wired to the 
resistor pack as a +5V source as shown in figure F-2. Attach the test clip to the 8287 
Octal Bus Transceiver at A69 (see figures F-1(a), F-3, and F-4). This will pull up the 
lower data lines during read operations of upper data bytes. 


To eliminate noise interference during I/O cycles, two solutions are recommended. 
The first solution can be used with either the iISBC 86/12 or an iSBC 86/12A that 
does not contain an iSBC 340 Multimodule EPROM Expansion Board. Mount a 
10K ohm resistor paek on a 20 pin I.C. test clip, pins 1 through 8 with pin 20 wired 
to the resistor pack as a +5V source as shown in figure F-2. Attach the test clip to the 
8286 Octal Bus Transceiver located at A45 (see figures F-1(b), F-3, and F-4). 


The second solution to I/O noise interference must be used with an iSBC 86/12A 
containing an iSBC 340 module EPROM Expansion Board. Mount 10K resistors on 
a 24 pin I.C. test clip, pins 9, 10, 11, and pins 13 through 17 with the resistors wired 
to pin 24 as a +5V source. Attach the test clip to the EPROM located at A46 on the 
iSBC 340 (see figures F-1(b), F-3, and F-5). 


By adding these two test chips to the iSBC board, the floating data lines will be 
pulled up and the cross-coupling between even and odd byte data lines will be 
eliminated. 


NOTE 


_ This problem does not exist when ICE-86A is used with other user circuits, 
or when iSBC 86/12 or iSBC 86/12A is used without ICE-86A. 
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ISBC 86/12 and iSBC 86/12A Fix 


ICE-86A 


+5V _ 


10K 


10K 


10K 


10K 


10K 


10K 


10K 


Figure F-1. The Piggyback Circuits Locations A45, A46, A69 of 
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iSBC 86/12™ and iSBC 86/12A™ 


(b) 


DB8 


DB9 


DBA 


-DBB 


DBC 


DBD 


DBE: 


DBF 


A45-1, OR 
A46-9 


A45-2, OR 
A46-10 


A45-3, OR 
A46-11 


A45-4, OR 
A46-13 


A45-5, OR 


A46-14 
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A46-17 
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iSBC 86/12 and iSBC 86/12A Fix 


ICE-86A 


\m& 


162554-17 


Figure F-2. Typical Application of I.C. Test Clips 
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CLOCK, A 


This appendix provides detailed information on use of the CLOCK, READY, and 
RWTIMEOUT commands. In this appendix, the term ‘‘Intel memory’’ refers to 
memory mapped to ICE RAM, Intellec expansion RAM, and/or disk storage. 


Set CLOCK Command 


The 8086 requires a clock signal input to provide a timing reference for all CPU 
activities. The ICE-86A emulator allows the clock signal to be supplied by either the 
user system or the ICE hardware. The source of the clock signal is determined by the 
set CLOCK command (CLOCK = INTERNAL or CLOCK = EXTERNAL). 


The command CLOCK = EXTERNAL is entered to select the user system clock 
signal to the 8086. An active user system clock must be present once this command 1s 
entered or the 8086 will not function. 


The 8086 read/write commands, which are generated for each bus cycle, are sent out 
to the user system when an external clock is selected. Therefore CLOCK must be set 
to external (and an active user system clock signal must be present) whenever any 


block of logical memory is mapped to the user system to ensure that the 8086 com- 


mand signals reach the memory components in the user system. 


Since the ICE-86A emulator assumes that all referenced I/O ports exist in the user 
system, CLOCK must be set to EXTERNAL (and an active user clock signal must be 
present) for I/O operations to ensure that the 8086 commands reach the port 
devices. This is true whether I/O ports are accessed directly or when emulating user 
code. 


There are some situations when it is desirable to set CLOCK to EXTERNAL even 
though all logical memory is mapped to Intel memory. Hardware debugging of a 
malfunctioning user system is one case where this combination of clock selection 
and memory mapping may be useful. The 8086 can execute code stored in Intel 
memory while the command signals can be observed in the malfunctioning user 
system. The only part of the user system that must be functioning properly during 
this debugging is the clock circuit. 


Near real time emulation of user code is another case where it may be useful to select 
an external clock even though all logical memory is mapped to Intel memory. Since 
the only part of the user system that must be present during this emulation is the 
clock circuit, software debugging at near real time speeds can begin before a com- 
plete user system is available. | 


The command CLOCK = INTERNAL is entered to select the 2-MHz ICE-86A 
emulator clock signal to the 8086. The 8086 command signals are not available to the 
user system and no user clock signal is required when the internal clock is selected. 


The internal emulator clock is typically selected when the ICE-86A emulator is used 
as a standalone software debugger or when all logical memory is mapped to Intel 
memory. It should be noted, however, that emulation with the 2-MHz ICE emulator 
clock signal may execute more slowly than with the faster clock signal usually found 
in a user System. 7 
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G2 


Guidelines for use ‘of oie fee and hie 


ENAB LE/DISABLE RDY Command 


The READY input to the 8086 allows interfacing the CPU to memory or I/O where 
the access time of the memory or I/O is. slower thanthe CPU buscycle. _ 


The ready signal is typically generated by acknowledge circuitry after an address has 


been decoded, but before the addressed location has been accessed. The 8086 CPU 


samples its READY input midway during each bus cycle. The processor proceeds 
with the bus cycle if an active ready signal is available at this sample time. However, 
if the ready signal is not active at sample time, the 8086 injects wait states into the 
bus cycle indefinitely until an active ready signal is detected. These wait states allow 
the 8086 CPU to be synchronized to slower memory or I/O. 


The ENABLE/DISABLE RDY command allows the user of the ICE-86A emulator 
to enable or disable the ready signal generated by the user system during read/write 
operations to Intel memory. The difference between the two modes of operation 
(ENABLE RDY and DISABLE RDY) is shown in simplified logic in figure G-1. 


In the ENABLE RDY mode, the ICE-86A emulator logically ANDs the user system 
ready signal with the ready signal from Intel memory for all memory operations. In 
the DISABLE RDY mode, the ready signal is provided by the emulator alone when 
accessing Intel memory; the emulator continues to AND the user system ready signal 


with the ready signal from Intel memory when accessing user system memory. 


The ENABLE RDY mode should be used during normal operation. In this mode, 
the 8086 CPU waits for both the user ready signal and the ICE emulator ready signal 
for all memory operations. Waiting for the user ready signal is necessary to avoid 
problems that may arise when user system memory is slower than Intel memory or is 
implemented with dynamic RAM devices. The following example describes such a 
problem. 


Assume two back-to-back memory cycles where the first cycle is to Intel memory 
and the second access is to user system memory. If the DISABLE RDY mode is 
used, the 8086 can complete the first cycle to Intel memory and begin the second 
cycle to user memory independent of the user ready signal. If the user memory is 
much slower than Intel memory or is in a refresh cycle, it may not have responded 
to/ recovered from the first cycle when the second cycle begins. 


MEMORY ACCESS | ENABLE RDY | DISABLE RDY | 


USER SYSTEM 
_ MEMORY ACCESS 


INTEL © 
MEMORY ACCESS 
(ICE, INTELLEC, 
OR DISK) 


_ Figure G-1. Sourceof 8086 READY Input = teases 
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If the ENABLE RDY mode is used, the second cycle cannot begin until both Intel 
memory and user memory are ready. 


The ICE-86A emulator is in the ENABLE RDY mode at initialization. 


The DISABLE RDY mode is typically selected (1) when the ICE-86A emulator 1s 
used as a standalone software debugger (no user system present); or (2) when the 
user system is being designed/debugged (no ready signal is being generated by the 
user system and/or a portion of program memory is mapped to Intel memory). In 
the DISABLE RDY mode, the ICE-86A emulator does not wait for the user ready 
signal for memory cycles to Intel memory. 


Set RWTIMEOQUT Command 


In emulation mode, an 8086 bus cycle to Intel memory may take up to a few 
milliseconds, although it may take longer when a disk access is required. (The 2K of 
ICE-86A emulator RAM, however, is very fast.) The read/write command signals 
are active for approximately the entire cycle. When CLOCK is set to EXTERNAL, 
the read/write commands are also active in the user system for the same period of 
time. This may cause problems with user system dynamic RAM devices such as 
2117s and 2118s. These RAM devices require a complete refresh cycle every 2 
milliseconds to guarantee data retention. The devices may lose their data if a refresh 
cycle is delayed due to command signals that are active on the user system for over 2 
milliseconds. 


The RWTIMEOUT command is used to deactivate the read/write command signals 
to the user memory after a time limit specified by the user of the ICE-86A emulator. 


_ This time limit allows the user memory refresh circuitry to proceed as required. 


The default value of RWTIMEOUT is 1000 microseconds, but can be changed by 
the ICE emulator user to any value greater than O and less than 32,000 or 
INFINITE. The command RWTIMEOUT = 500, for example, deactivates the 
read/write command signals to user memory 500 microseconds after a memory cycle 
begins, even though the cycle to Intel memory is still in progress. 


Dynamic RAM devices with a 2 millisecond refresh cycle specification will 
typically hold data for much longer periods of time without refresh; 
sometimes for several seconds. Therefore an ICE-86A emulator user may 
set RWTIMEOUT = INFINITE and still observe no problems in user 
memory, even when accessing memory mapped to disk (5 milliseconds is 
typical for disk access, but some disk operations may take several seconds). 
However, not all RAM devices will hold data past the 2 millisecond limit. 
Loss of data may result when this limit is exceeded. It is recommended that 
RWTIMEOUT never exceed 10 milliseconds. 


If ERROR is specified in the RWTIMEOUT command, the ICE-86A emulator 
checks the user system ready signal and reports timeouts to the user. For example, if 
the command RWTIMEOUT = 1000 ERROR is entered, a ready timeout is reported 
during emulation if no user ready is received within 1000 microseconds of the start 
of a memory cycle. RWTIMEOUT = 1000 ERROR is a useful setting when Intellec 
and disk memory are not accessed. 7 


If Intellec and/or disk memory are used, the recommended setting is RWTIMEOUT 
= 1000 NOERROR. Read/write commands to the user system are terminated 1000 
microseconds after the start of a memory cycle, but the emulator does not report 
ready time-outs which may otherwise occur during access to Intellec or disk 
memory. 
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Summary of CLOCK, READY, and RWTIMEOUT 


Table G-1 illustrates the possible combinations of the CLOCK and 


ENABLE/DISABLE RDY commands for various memory mappings. The discus- 
sion below summarizes the guidelines for using CLOCK, READY, and 
RWTIMEOUT. | 


1. 


Table G-1. CLOCK and ENABLE/DISABLE RDY Commands 


User Cable | | Socket 
Connected User System Protector 
to: : Assembly 


Logical Memory : ; User and 
Mapped to: 


*Recommended 


In standalone mode, ICE-86A is not connected to a user system. CLOCK must 
be set to INTERNAL and the DISABLE RDY mode must be used. 


2. When accessing user memory, CLOCK must be set to EXTERNAL and the 


ae 


ENABLE RDY mode should be used. 


RWTIMEOUT = 1000 NOERROR is the recommended setting when accessing 
Intellec and disk memory. | | | 
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INSTALLING UPGRADE KIT 


The Upgrade Kit converts an ICE-86 emulator to an ICE-86A emulator. The follow- 
ing instructions detail procedures for installing the Upgrade Kit for the Intellec 
Model 800 and 888 Systems or the Intellec Series II System. 


Installation Procedure for the Intellec 
Model 800 and 888 Systems 


Pe WN — 


. Disconnect the power cords of the Intellec chassis and user system. 

. Inspect the ICE-86U assemblies for damage. 

. Remove the top cover of the Intellec chassis. 

. The ICE-86 circuit boards consist of an FM Controller board, an ICE-86 Trace 


board, and an 86 Controller board. The ICE-86 buffer box is connected by two 
cables to the 86 Controller board and the FM Controller board at terminals_on 
the boards marked ‘‘X”’ and ‘“‘Y,’’ respectively. Disconnect these cables from 
the circuit boards. 


. On the side of the ICE-86 buffer box opposite to that which the circuit board 


cables are attached to, there is a “‘user cable’’ ending in a forty-prong plug. If 
the user cable is attached to the user’s prototype application system, then 
disconnect it. 


. Also at the end of the user cable ts a black plug receptacle. Inserted into this 


receptacle should be the male plug end of the ICE-86 Ground Connector; the 
other end of the Ground Connector should be clipped to system ground. Unclip 
the system ground end of the Ground Connector. 


7. Set aside the ICE-86 buffer box. 
8. Remove the FM Controller board from its chassis slot. 
9. The ICE-86 firmware consists of six PROM?’s on the FM Controller board at 


10. 


11. 
12. 
13. 


14. 
15. 


locations labeled A2 through A7 on the board. Remove and set aside the ICE-86 
firmware. 


The ICE-86A firmware consists of six PROM’s labeled A2 through A7. Attach 
these PROM’s to the FM Controller board at the locations formerly occupied 
by the ICE-86 firmware, making sure to match the labels on the tops of the 
PROM’s with the labels on the board. 


Examine the newly-installed firmware to be sure all pins have made contact with 
the FM Controller board. 


Re-insert the FM Controller board into the chassis slot it previously occupied. 


The ICE-86 Trace board and the 86 Controller board are connected by a “T 
cable’’; this cable is attached to the boards at ermultals labeled ‘‘T.’? Remove 
the T cable. 


Remove the 86 Controller board. 


In order to enable External Break, examine the solder side of the 86 Controller 
board for continuity from pin 40 of J2 (the X cable terminal) to pin 5 of RPI (a 
resistor pack). Continuity exists between the two points if 0 ohms is detected 
between the points or if the 86 Controller board part number is 1001879-03 


16. 
17. 


18. 


19. 


20. 


Zh: 


22: 
23, 
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Rev. F or later. If continuity exists, then proceed to instruction #16. If the wire 
is not in place, then the user can make the connection or can contact Intel 
service for assistance. : 


The user should avoid applying excessive heat to the 86 Controller 
board while soldering; the traces on the back of the board will 
detach themselves if exposed to enough heat. A soldering iron with 
amaximum power of 15 to 20 watts is recommended. After solder- 
ing has been completed, the user should check for solder splashes 
that can short parts of the board. The user should also examine the 
wire to be sure good physical contact has been made with the pins. 


Re-insert the 86 Controller board into the chassis slot it previously occupied. 
Reattach the T cable to the ICE-86 Trace board and the 86 Controller board, 


making sure to mate the blocked inserts on the cable receptacles with the missing 
pins on the board terminals. 


The ICE-86 buffer box has a pair of éable: coming out of one side contained 
within a rubber zipper tube. At the end of each cable is a 40-pin receptacle; one 
receptacle is marked ‘‘X’’ and one is marked ‘‘Y’’ (corresponding to the circuit 
board cables of the ICE-86 buffer box). Attach the buffer box cable receptacle 
marked ‘‘X’’ to the 86 Controller board terminal marked ‘‘X,’’ making sure to 
mate the missing pin on the board terminal with the blocked insert on the cable 
receptacle. 


Attach the buffer box cable receptacle marked ‘‘Y”’ to the FM Csntoller board 
terminal marked ‘‘Y,’’ making sure to mate the missing pin on the board ter- 
minal with the blocked insert on the cable receptacle. 


If a user prototype application system is to be connected, remove the Socket 
Protector assembly from the user cable of the ICE-86 buffer box and insert the 
40-pin cable terminal into the 8086 socket on the user system. The Socket 
Protector assembly guards the terminal pins from comage: and inadvertent 
grounding. 

At the end of the ICE-86A buffer box user cable is a black plug receptacle 
corresponding to the one at the end of the ICE-86 buffer box user cable. Insert 
into this receptacle the male plug end of the ICE-86A Ground Connector, and 
clip the other end of the Ground Connector to system ground. 


Replace the top cover of the Intellec chassis. 


Re-insert the power cords of the Intellec chassis, the Expansion Chassis, and 
user system into their power sources. 


Installation Procedure for the Intellec Series II Systems 


Disconnect the power cords of the Intellec chassis and user system. 


2. Inspect the ICE-86U assemblies for damage. 


. Remove the front cover of the penn chassis housing the ICE-86 circuit 


boards. 


. The ICE-86 circuit boards consist of an FM Controller board, an ICE-86 Trace. 
board, and an 86 Controller board. The ICE-86 buffer box is connected by two 


~~ cables to the 86 Controller board and the FM Controller board at terminals on 


the boards marked pe ang oY, es respectively. Disconnect these cables from i 


the circuit boards. 
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. On the side of the ICE-86 buffer box opposite to that which the circuit board 


cables are attached to, there is a ‘‘user cable’’ ending in a forty-prong plug. If 
the user cable is attached to the user’s prototype application system, then 
disconnect it. 


. Also at the end of the user cable is a black plug receptacle. Inserted into this 


receptacle should be the male plug end of the ICE-86 Ground Connector; the 
other end of the Ground Connector should be clipped to system ground. Unclip 
the system ground end of the Ground Connector. 


. Set aside the ICE-86 buffer box. 
. Remove the FM Controller board from its chassis slot. 
ee 2 


The ICE-86 firmware consists of six PROM’s on the FM Controller board at 
locations labeled A2 through A7 on the board. Remove and set aside the ICE-86 
firmware. 


. The ICE-86A firmware consists of six PROM’s labeled A2 through A7. Attach 


these PROM’s to the FM Controller board at the locations formerly occupied 
by the ICE-86 firmware, making sure to match the labels on the tops of the 
PROM’s with the labels on the board. 


. Examine the newly-installed firmware to be sure all pins have made contact with 


the FM Controller board. 


. Re-insert the FM Controller board into the chassis slot it previously occupied. 
. The ICE-86 Trace board and the 86 Controller board are connected by a ‘‘T 


cable’’; this cable 1s attached to the boards at terminals labeled ‘‘T.’’ Remove 
the T cable. 


Remove the 86 Controller board. 


To enable External Breaks, examine the solder side of the 86 Controller board 
for continuity from pin 40 of J2 (the X cable terminal) to pin 5 of RPI (a 
resistor pack). Continuity exists between the two points if 0 ohms is detected 
between the points or if the 86 Controller board part number is 1001879-03 
Rev. F or later. If continuity exists, then proceed to instruction #16. If the wire 
is not in place, then the user can make the connection or can contact Intel serv- 


ice for assistance. — 


The user should avoid applying excessive heat to the 86 Controller 
board while soldering; the traces on the back of the board will 
detach themselves if exposed to enough heat. A soldering iron with 
a maximum power Of 15 to 20 watts is recommended. After solder- 
ing has been completed, the user should check for solder splashes 
that can short parts of the board. The user should also examine the 
wire to be sure good physical contact has been made with the pins. 


. Re-insert the 86 Controller board into the chassis slot it previously occupied. 


. Reattach the T cable to the ICE-86 Trace board and the 86 Controller board, 
making sure to mate the blocked inserts on the cable receptacles with the missing . 


pins on the board terminals. 


. The ICE-86 buffer box has a pair of cables coming out of one side contained 
within a rubber zipper tube. At the end of each cable is a 40-pin receptacle; one 


receptacle is marked ‘‘X’’ and one is marked ‘‘Y’’ (corresponding to the circuit 
board cables of the ICE-86 buffer box). Attach the buffer box cable receptacle 


marked “‘X’’ to the 86 Controller board terminal marked ‘‘X,’’ making sure to. 
mate the missing pin on the board terminal with the blocked insert on the cable 


receptacle. 
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-20. 


? 21. 


22. 


23. 


Attach the buffer box cable receptacle marked ‘‘Y’’ to the FM Controller board 
terminal marked ‘‘Y,’’ making sure to mate the missing pin on the board ter- 
minal with the blocked insert on the cable receptacle. 


If a user prototype application system is to be connected, remove the Socket 
Protector assembly from the user cable of the ICE-86 buffer box and insert the 


40-pin cable terminal into the 8086 socket on the user system. The Socket — 


Protector assembly guards the terminal pins from damage and madverient 
grounding. 


At the end of the ICE-86A buffer box user cable is a black side receptacle 
corresponding to the one at the end of the ICE-86 buffer box user cable. Insert 
into this receptacle the male plug end of the ICE-86A Ground Connector, and 
clip the other end of the Ground Connector to system ground. 


Replace the front cover of the expansion chassis housing the ICE-86 circuit 
boards. 


Re-insert the power cords of the Intellec chassis, the Expansion Chassis, and 
user system into their power sources. 
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8087 DEBUGGING SUPPORT 


Introduction 


When an 8087 NDP (Numeric Data Processor) shares a system bus with an 8086 
CPU, the arithmetic abilities of the 8086 processor are expanded to include floating 
point calculations. The ICE-86A emulator can be used as a debugging tool for the 
8087 chip or the 8087 software emulator. To debug floating point operations in user 
software, a file of Floating Point MACROS has been added to the ICE-86A system 
disk; the name of the file is 8087.MAC. The details of these MACROS are given 
below. For further information concerning the 8087 NDP in general, the user should 
consult The 8086 Family Users Manual Numerics Supplement, Manual Order 
Number 121586. 


NOTE 


ICE-86A hardware is not equipped to monitor the system bus while another 
device, such as the 8087 NDP, is in control. Therefore, the emulator’s 
breakpoint capabilities are not available when it is not the system bus 
master. Hence, ICE-86A support for the 8087 NDP can be best character- 
ized as a software debug aid, rather than, as it is for the 8086 processor, a 
system design tool. 


The MACROS are merely sets of ICE-86A commands like those entered at 
the console. They are intended to be very general and are therefore fairly 
slow in execution. Users may model their own 8087 debugging aids on these 


macros. ; 


The Floating Point Macros use four ICE variables named: 
2721 .27Z2 .2?Z3 «.2Z4 


If the user has created any variables with these names, they will conflict 
when running the Floating Point Macros. 


The Status Block 


Almost all of the floating point MACROS access 108-byte blocks of memory termed 
““status blocks.’’ These status blocks contain: 


1. status and variables used by the MACROS, 
2. code for execution, | 

3. temporary 8086 register values, 

4. 8087 or emulated 8087 register values. 


When using the 8087 chip, status blocks can only be stored in user memory; that is, 
the memory used for those macros must be mapped to user memory. Because of 
8087 control of the system bus, it is impossible to transfer information to Intellec, 
disk, or ICE memory. This does not occur when using the software emulator for the 


8087; since the software is stored in the 8086 CPU, the emulated 8087. 


microprocessor has access to the same memory space as the 8086 microprocessor. 


The FLAG byte of a status block (byte 0) indicates whether the 8087 chip or the 8087 
~ emulator is being used. | 
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The COMMAND bytes (bytes 1 through 5) are a workspace area where the called 


MACRO writes commands for the controlling device to execute. 


The REGISTER bytes (bytes 6 through 13) are used as a save area for 8086 registers. 
The CS, IP, DS, and DI 8086 registers are temporarily stored in these bytes during © 


the execution of the GETBLK and PUTBLK MACROS. These MACROS overwrite 
the 8086 registers as part of their status information transferal procedures. The 8086 
registers are restored after execution has been completed. 


The BLOCK bytes (bytes 14 through 107) contain the actual NDP status informa- 
tion. This information includes the Command, Status, and Tag Words, as well as 
the NDP stack. It also contains the last instruction address, the last operation, and 
the last operand address if the operation referred to an operand. 


See figures I-] through I-7 for illustrations of these formats. 


Floating Point Macro Side Effects 


Most of the floating point MACROS contain a DISABLE EXPANSION Com- 
mand. That is, they suppress the display of MACRO code prior to execution. This is 
done for user convenience. To restore display, use the ENABLE EXPANSION 
Command. (See Chapter 8 for the ENABLE/DISABLE EXPANSION Command.) 


The GETBLK and PUTBLK MACROS temporarily disable TRACE. This is done 
to prevent status block information transferal instructions from being recorded in 
the TRACE registers. Under normal circumstances, the loading and unloading of 
status blocks has no relation to the process being emulated. 


The TRACE facility is enabled following execution of either the GETBLK 
or PUTBLK MACROS regardless of the facility’s state prior to the 
MACRO invocation. If the user desires that TRACE be disabled after call- 
ing either of these MACROS, then the user must enter the DISABLE 
TRACE Command (see Chapter 6). 


The GO and. Breakpoint registers are also altered. These registers are used in the 
transferal of status block information. 
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Figure I-2. Register Bytes Format 


~ 162554-10. 


162554-11 
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INCREASING ADDRESSES OFFSET BY 14 


CONTROL WORD +0 
STATUS WORD +2 
TAG WORD +4 
a ee 
INSTRUCTION 
POINTER 


15° | 0 


IP19-16 0 OPCODE +8 


TOP STACK 
ELEMENT:ST 


+10 
OPERAND 
POINTER 


+12 


+14 


+16 


+18 


+20 


SIGNIFICAND 63-48 


EXPONENT 14-0 
Oo. 


+22 


+24 


+26 


s EXPONENT 14-0 


SIGNIFICAND 15-0 +84 


NEXT STACK 


ELEMENT:ST(1) +28 


+30 


+32 


LAST STACK 
ELEMENT:S1(7) 


SIGNIFICAND 47-32 +88 
SIGNIFICAND 63-48 +90 


s EXPONENT 14-0 +92 


1 SIGNIFICAND 31-16 +86 


NOTES: 
S = Sign 
Bit 0 of each field is rightmost, least significant bit of corresponding 
register field. 
Bit 63 of significand is integer bit (assumed binary point is immediately 
to the right). 


Figure I-3. Block Bytes Format 162554-12 
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7 0. 
Lo pe} rc | re fre] [em|une}om] za }ose| 


EXCEPTION MASKS (1 = EXCEPTION IS MASKED) 
“INVALIDOPERATION 
DENORMALIZED OPERAND 
ZERODIVIDE 
OVERFLOW 
UNDERFLOW 
PRECISION 
(RESERVED) 
INTERRUPT-ENABLE MASK(1) 
PRECISION CONTROL() 
ROUNDING CONTROL() 
INFINITY CONTROL(4) 
(RESERVED) 


(1) Interrupt-Enable Mask: 
0 = interrupts Enabied 
1 = Interrupts Disabied (Masked) 


(2) Precision Control: 
00 = 24 bits 
01 = (reserved) 
10 = 53 bits 
11 = 64 bits 
(3) Rounding Control: 
00 = Round to Nearest or Even 
01 = Round Down (toward —-) 
10 = Round Up (toward +) 
11 = Chop (Truncate Toward Zero) 
(4) Infinity Control: 
0 = Projective 
1 = Affine 


Figure I-4. Control Word Format 162554-13 


15 


7 0 
petes} st, _fezjerfeofm]  [re| ve} oe| ze] oe] re | 
| | | EXCEPTION FLAGS (1 = EXCEPTION HAS OCCURRED) 
INVALID OPERATION 


DENORMALIZED OPERAND 


ZERODIVIDE 
OVERFLOW 


: 


UNDERFLOW 

PRECISION 
(RESERVED) 
INTERRUPT REQUEST 
CONDITION CODE(") 
STACK TOP POINTER(2) 
- BUSY 


(1) See descriptions of compare, test, examine and remainder instructions in section S.7 for 
condition code interpretation. 


(2) ST values: 
000 = register 0 is stack top 
001 = register 1 is stack top 
e 


e 
111 = register 7 is stack top 


Figure I-5. Status Word Format | - 162554-14 
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Tag values: 
00 = Valid (Normal or Unnormal) 
01 = Zero (True) 
10 = Special (Not-A-Number, =, or Denormal) 
11 = Empty 


Figure I-6. Tag Word Format 162554-15 


OPERAND ADDRESS() 
INSTRUCTION OPCODE(2) 
INSTRUCTION ADDRESS() 


10 0 
(1) 20-bit physical address | 
(2) 11 least significant bits of opcode; 5 most significant bits are always 8087 hook (11011B) 


Figure I-7. Exception Pointers Format | 162554-16 


The Define Block Macro 

SYNTAX :DEFBLK symbol, pointer-address ,ndp 
where ndp = 8087: :87: :87E 

RESULT Defines a status block at a given location in memory to be 
accessed by the MACROS and assigns it a symbolic value. 
‘*8087°’ and ‘‘87’’ both refer to the 8087 NDP; ‘‘87E’’ indicates 
the 8087 software emulator. The pointer-address is the beginning 
address of the block (in user memory if using the 8087 chip). 

SIDE EFFECTS None. 


Example: 


:DEFBLK .ONE,0:2000,87 


The Get Block Macro 
SYNTAX :GETBLK symbol 
RESULT ~ Reads the NDP status into the selected status block. 


SIDE EFFECTS MACRO expansion disabled. TRACE temporarily disabled. 8086 
registers temporarily stored in REGISTER bytes. The Go and 
Breakpoint registers are altered. 


Example: 


-GETBLK .ONE 
*** TRACE now on" 
EMULATION BEGUN 
EMULATION TERMINATED, CS:!IP=0000:2006H 
*** TRACE now on *** 
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SYNTAX ~~ :PUTBLK symbol 


RESU LT Writes the status block to the NDP. 


SIDE EFFECTS MACRO expansion disabled. TRACE temporarily disabled. 8086 — 


registers temporarily stored in REGISTER bytes. If the 8087 soft- 
ware emulator is executing the MACRO commands, then the Go 
and Breakpoint registers are altered. 
Example: 
-PUTBLK .ONE 
EMULATION BEGUN 


EMULATION TERMINATED, CS:IP=0000:2006H. 
*** TRACE now on *** | 


The Remove Block Macro 
SYNTAX -REMBLK symbol 


RESULT Releases the 108 bytes in memory associated with the status block 
name and removes the status block name from the symbol table. 


SIDE EFFECTS None. 
Example: 


*:REMBLK .ONE 


The Display Stack Macro 


SYNTAX “STACK symbol 


RESULT Displays NDP stack elements and their associated tags in 


hexadecimal format. 
SIDE EFFECTS. MACRO expansion disabled. Display base becomes hexadecimal. 
Example: 


*:STACK .ONE | 

REGISTER VALUE TAG 
“eae ae (hi) ee (lo) | 
ST(00H) 3FH FFH 80H 00H 00H 00H 00H 00H 00H 00H _ 03H 
- ST(01H) 40H 00H 80H 00H 00H 00H 00H 00H 00H 00H 02H 
ST(02H) 40H 00H C7H DFH 3BH 64H 5AH 1CH ACH 08H 01H 
ST(03H) 40H OCH COH E6H B7H 31H 8FH C5H 04H 81H 00H 
ST(04H) = BFH BCH BAH 90H 08H 4AH 15H 89H EDH FOH 03H 
ST(05H). 50H 02H A8H 85H 04H B9H 03H 30H DBH E2H 02H 
—ST(O6H) 40H 31H 8CH 4DH B7H F3H 40H 3EH 40H 00H 01H 
ST(07H) 40H 02H 80H 00H 00H 00H 00H 00H: 00H 00H 00H 
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The Evaluate Stack Macro 


SYNTAX -EVALSTK symbol 
RESULT Displays NDP stack elements in decimal format and 
disassembled. 


SIDE EFFECTS MACRO expansion disabled. 


Example: 
*-EVALSTK .ONE 
REGISTER VALUE TAG 
ST(O0H) + 1.00000000000000000E + 0 FREE 
ST(01H) + 2.00000000000000000E + 0 NaN /INFINITE/DENORMAL 
ST(02H) + 3.12300000000000000E + 0 ZERO 
ST(03H) + 1.23456789000000000E + 4 VALID 
ST(04H) — 9.87654321000000000E—21 FREE 
ST(05H) + 1.10000000000000000E + 1234 NaN /INFINITE/DENORMAL 
ST(06H) + 1.23412341234123400E + 15 ZERO 
ST(07H) + 8.00000000000000000E + 0 VALID 


The Display Status Macro 
SYNTAX ‘STATUS symbol 


RESULT Displays the Status, Control, and Tag Words, and _ their 
associated bit maps. It also displays the last instruction address, 
the last operation, and the last operand address 


SIDE EFFECTS MACRO expansion disabled. 
Example: 


*STATUS .ONE 

CONTROL WORD: 

BIT MAP = |x| x] x] AC | RC(2) | PRE(2)|/|M|x|MP|MU|MO|MQ]|MD{Mi| 
WOR 0000:200EH=0000001011111111Y 


STATUS WORD: 
BIT MAP = |B] Z| TOP(3)|CIA|S|/|N]x]P|U]O|Q|D]1| 
WOR 0000:2010H=0100000100000000Y 


TAG WORD: 

BIT MAP = | T7(2) | T6(2) | T5(2) | T4(2) | / | T3(2) | T2(2).| T1(2) | TO(2) | 

NOTE: Tags are mapped to absolute registers, they are not stack relative 
WOR 0000:2012H=0001101100011011Y 


INSTRUCTION ADDRESS: (pseudo base-displacement) 
F000:C9DEH 


LAST OPERATION: (8087 format) 
CDH 1CH 


OPERAND ADDRESS: (pseudo base-displacement) 
0C04H 
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The Evaluate Status Macro 


SYNTAX 
RESULT 


:-EVALSTAT symbol 


Evaluates Control and Status Words and displays information to 
the user. Displayed are the infinity arithmetic, rounding, and 
precision formats, masked bits, the state of the ZERO and BUSY 
flags, the pointer to the top of the NDP stack, the state of error- 
handling flags, and error warning messages for standard types of 
errors. 


SIDE EFFECTS MACRO expansion disabled. 


Example: 


*-EVALSTAT .ONE 
CONTROL WORD: 
CLOSURE = PROJECTIVE 
ROUNDING = NEAREST/EVEN 
DOUBLE PRECISION 
MASK = TRUE 
MASK BITS SET: 
PRECISION ERROR 
UNDERFLOW ERROR 
OVERFLOW ERROR 
DIVIDE BY ZERO ERROR | 
DENORMALIZATION ERROR 
INVALID ERROR 
STATUS WORD: 
BUSY = FALSE 
C3(ZERO) = TRUE 
TOP = REGISTER 00H 


C2 = FALSE 
-C1=FALSE 


CO0(SIGN) = 01H 
INTERRUPT = FALSE 
ERROR FLAGS SET: 


The Evaluate Control Word Macro 


SYNTAX 
RESULT 


-EVALCW symbol 


Evaluates Control Word and displays information to user. 
Displayed are infinity arithmetic, rounding, and precision for- 
mats, masked bits, and error warning messages for standard types 
of errors. 


SIDE EFFECTS MACRO expansion disabled. 


Example: 


-EVALCW .ONE 


CONTROL WORD: 
CLOSURE = PROJECTIVE 
ROUNDING = NEAREST/EVEN 
DOUBLE PRECISION 
MASK = TRUE 
MASK BITS SET: 
PRECISION ERROR 
UNDERFLOW ERROR 
OVERFLOW ERROR 
DIVIDE BY ZERO ERROR 
DENORMALIZATION ERROR 
INVALID ERROR 
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The Evaluate Status Word Macro 
SYNTAX -EVALSW symbol 


RESULT Evaluates Status Word and displays information to user. 
Displayed are the state of the ZERO and BUSY flags, the pointer 
to the top of the NDP stack, the state of error-handling flags, and 
error warning messages for standard types of errors. 


SIDE EFFECT MACRO expansion disabled. 
Example: 


-EVALSW .ONE 
STATUS WORD: 
BUSY =FALSE 
C3(ZERO) = TRUE 
TOP = REGISTER 00H 
C2 = FALSE 
C1 = FALSE 
CO(SIGN) = 01H 
INTERRUPT = FALSE 
ERROR FLAGS SET: 


The Display or Change Control Word Macro 


SYNTAX :CW symbol |,=word-value | 


RESULT Display or change of the Control Word in the current base. If 
:CW symbol is entered, then the value of the Control Word is 
displayed. If :CW symbol ,=word value is entered, then display is 
suppressed and the value of the Control Word is changed to 


word-value. 


Bits 6, 13, 14, and 15 of the Control Word are unassigned 
and reserved. The operator should avoid altering the 
value of these bits, as this may lead to an incompatibility 
with the ICE-86A module. 


SIDE EFFECTS None. 
Examples: 
*:CW .ONE,=2FF 


* 


*:CW .ONE 
WOR 0000:200EH=02FFH 


The Display or Change Status Word Macro 

SYNTAX :SW symbol |,=word-value | 

RESULT Display or change of the Status Word in the current base. If :SW 
7 symbol is entered, then the value of the Status Word is displayed. 


If :SW symbol ,=word-value is entered, then display is suppressed 
and the value of the Status Word is changed to word-value. 
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SIDE EFFECTS None. 
Examples: 
— “SW .ONE,=4100 


—*:SW.ONE 
WOR 0000:2010H=4100H 


The Display or Change Tag Word Macro 


SYNTAX :TW symbol |,=word-value | 


RESULT Display or change of the Tag Word in the current base. If :TW | 


symbol is entered, then the value of the Tag Word is displayed. If 
:SW symbol,=word-value 1s entered, then display is suppressed 
and the value of the Tag Word is changed to word-value. 


SIDE EFFECTS None. 
Examples: 
“TW .ONE,=1B1B 


*:TW .ONE 
WOR 0000:2012H=1B1BH 


The Display or Change Stack Macro 
SYNTAX :STK symbol,offset {,=real-value] 


where offset is an integer from 0 to 7 representing the distance of 
an element from the top of the NDP stack. 


RESULT Display or change of individual NDP stack elements in decimal 
format. If :STK symbol offset is entered, then the offset-th of the 
stack is displayed. If :STK symbol ,offset ,=real-value is entered, 


then display is suppressed and the value of the offset-th element 


of the stack is changed to rea/-value. 
SIDE EFFECTS MACRO expansion disabled. 
Examples: 


*:STK .ONE,0,=1.0 
*-STK .ONE,7,=8. 
*:STK .ONE,0 
~ TRE 0000:201CH= + 1.00000000000000000E +0 


x, 


"STK .ONE,7 | | 
TRE 0000:2062H= + 8.00000000000000000E + 0 
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The Display Stack Address Macro 


SYNTAX 


RESULT 


SIDE EFFECTS 


Example: 


:STKADDR symbol offset 


where offset is an integer from 0 to 7 representing the distance of 
an element from the top of the NDP stack. 


Displays the memory location of a particular NDP stack element 
so that the user may access the individual bytes of the stack. The 
display occurs in all four bases—binary, octal, decimal, and 


hexadecimal—and also includes the corresponding ASCII 


characters. (The STKADDR MACRO is based on the 
EVALUATE command; see Chapter 7 for details.) The hexa- 
decimal value refers to the lowest byte in logical memory where 
the stack element is stored; the stack element is contained in ten 
consecutive bytes, starting at the byte listed. (In the example given 
below, for instance, ‘‘201CH’’ means that the stack element is 
stored in bytes 201CH through 2025H in logical memory.) 


MACRO EXPANSION disabled. 


*:STKADDR .ONE,0 
10000000011100Y 20034Q 8220T 201CH ° ’ 
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The following is a listing of the Floating Point Macros with comments. It is con- 
tained in the file 8087 -HLP on the ICE-86A diskette. | 


:8087 SUPPORT MACROS € INTEL 1981 


KRHEEKKEKEKKKEEEKKEKEKKKEKKEEKKEKKRRKRKRKRKRKKERKKEKKRKKRKKKRKEREKRK:E 


DEFINE LOCAL SYMBOLS (VARIABLES) 


We we CO we we 


DEFINE .?Z1=0 
DEFINE .?22=0 
DEFINE .?23=0 
DEFINE .?Z4=0 
TTT TTT TT TIT TIT TIT IT TILT LITT TI TTT TT TTT TTT Tite 

> 

DEFINE MACRO DEFBLK 

DISABLE EXPANSION 

IF (OFFSET (41) + 108T) < OFFSET (41) THEN , 

>THE OFFSET SELECTED MUST BE ABLE TO REACH THE 108 BYTES OF THE DATA BLOCK 
WRITE ° OFFSET VALUE TOO HIGH - TRY AGAIN’ 


ELSE 

DEFINE 40 = Z1 3 SYMBOL GETS ADDRESS VALUE 
IF %2H = 8087N THEN 

BYTE %1=OFFH sTRUE FOR 8087 

ORIF %2H = 87H THEN 

BYTE %1 = OFFH  ;87 == 8087 

ELSE | 
BYTE %1 = 0 ;FALSE FOR 87 EMULATOR 
ENDIF 

ENDIF 

EM 


9 
g RRAAKKAKKKEEKRKEKKREKKEKEREKREKERKRERRERKKRKKRKKKKKEKEKK 


b 
DEFINE MACRO GETBLK 
DISABLE EXPANSION ;DISABLE THE MACRO EXPANSION 


DISABLE TRACE ;DON’T TRACE THE FLOATING POINT EXECUTION 
WRITE °*** TRACE now off ***’ : 

WORD %0+6T = CS ;SAVE CURRENT EXECUTION LOCATION 

WORD 4O0+8T = IP 

WORD %Z%0+10T = DS >SAVE POINTERS 

WORD %Z0+12T = DI 

DS = SEGMENT(Z0) >SEGMENT ADDRESS OF USER-DEFINED BLOCK 


DI = OFFSET(Z04+14T) ;SET OFFSET TO BEGINNING OF 8087 EXTERNAL REGISTER AREA 


IF (BYTE 40) THEN 3;I1F 8087 THEN... 
BYTE 40+1 = 9BH,DDH,35H,9BH,F4H 3;WAIT, SAVE ALL OF 8087 REGISTERS, WAIT, HALT 


GO FROM 40+1 TILL HALT ;WAIT, EXECUTE THE FSAVE, WAIT, AND HALT 
ELSE ;IF 87 EM THEN... | 
BYTE Z40+1 = CDH,1DH,35H,F4H 3;GET ALL STATUS FROM 87EM 


GO FROM 4041 TILL HALT 
WRITE °*** GR and BR registers altered ***’ 


CS = (WORD Z40+6T) sRESTORE 8086 REGISTERS 
IP = (WORD 240+8T) 
DS = (WORD 40+10T) 

DI = (WORD 40+12T) 

ENABLE TRACE ;AND TRACE 

WRITE ’*** TRACE now on ***’ 

EM 


> 
sR KRAKKKKEKKEKKEAREKRKEKKKRKKREKEEKEKEKKEKKKKKKK 


> 

DEFINE MACRO PUTBLK 

DISABLE EXPANSION >sDISABLE MACRO EXPANSION 

DISABLE TRACE ;DON’T TRACE THE FLOATING POINT EXECUTION 
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WORD Z0+6T = CS ;SAVE CURRENT EXECUTION LOCATION 

WORD Z20+8T = IP 

WORD Z0+10T = DS ;SAVE DATA SEGMENT AN OFFSET POINTERS 

WORD 204+12T = DI 

DS = SEGMENT(Z0) ;SEGMENT ADDESS OF USER-DEFINED BLOCK 

DI = OFFSET(Z0+14T) ;POINT TO DATA AREA HOLDING ALL OF 8087 ENVIRONMENT 
IF (BYTE 40) THEN ;IF 8087 THEN... 


BYTE ZO+1 = 9BH,DDH,25H,9BH,F4H ;WAIT, RESTORE 8087 ENVIRONMENT, WAIT, HALT 
GO FROM Z0+1 TILL HALT ;WAIT, EXECUTE THE FRSTOR, WAIT, AND HALT 

ELSE — -IF 87 EM THEN... 7 

BYTE ZO+1 = CDH,1DH,25H,F4H sRESTORE STATUS TO 87EM 

GO FROM 40+1 TILL HALT 

WRITE ’*** GR and BR registers altered ***’ 


ENDIF 

CS = (WORD 20+6T) s;RESTORE 8086 REGISTERS 
IP = (WORD 2%0+8T) 

DS = (WORD Z0+10T) 

DI = (WORD Z40+12T) 


ENABLE TRACE ;AND TRACE 

WRITE °*** TRACE now on ***’ 

EM 

RIO I ITO GIO IOI TOI A IOIOk 


9 

DEFINE MACRO REMBLK 

REMOVE 40 ;REMOVE BLOCK FROM SYMBOL TABLE 
EM 


> 
s RR RKRAKKEKKEKKKEKEKKKKREKERKEKREEKKEKKEKKEKKKE 


: | 
DEFINE MACRO STATUS 

;DISPLAY THE STATUS WORD, CONTROL WORD, TAG WORD, AND THE LAST INSTRUCTION 
s;ADDRESS, OPCODE, AND OPERAND TYPE. 

DISABLE EXPANSION 


BASE = Y 

WRITE ’CONTROL WORD: ’ 

WRITE ° BIT MAP = [x] xIx]AC{RC(2)|]PREC2)1/IMIxXIMPINUIMO[MQIMDINI|] ’ 
:CW Z0 | 
WRITE ’” ” 

WRITE ’STATUS WORD: ’ 

WRITE °% BIT MAP = |BIZITOPC3)ICIAISI/INIXIPIUIOIQIDILI’ 

:SW 20 

WRITE ’ ” 

WRITE ’TAG WORD: ’ 

WRITE ° BIT MAP = {77(2)1T6(02)1T5(2)1T4(2)(/1T3€2)/T2€2)1T102)1T0(2)] ’ 


WRITE ° NOTE: Tags are mapped to absolute registers, they are not stack relative’ 
:TW ZO 

BASE = H 

‘WRITE ’% ’ 

WRITE ’ ” 

WRITE “INSTRUCTION ADDRESS: (pseudo base-displacement )’ 

WRITE (CCBYTE 404+23T)/16T*4K):CWORD 40+20T)) ;GET UPPER 4& BITS OF 20 BIT 
;ADDRESS, MAKE IT INTO A SEGMENT VALUE. PRINT THE LOWER 16 BITS AS OFFSET. 
WRITE ’ ” | 7 

WRITE ’LAST OPERATION: (8087 format)’ 

WRITE C8H+( (BYTE 40+23T) AND O7H),’ °,BYTE %0+22T 

WRITE ’° ” 

WRITE ’OPERAND ADDRESS: (pseudo base-displacement)’ 

WRI CCCBYTE 404+27T)/16T*4K): (WORD Z04+24T) ) 

EM 

TTT T TTT TITEL ITI TE TTT TLeTeTeTTeeTeeeTee 


> 

DEFINE MACRO STACK 

DISABLE EXPANSION 

BASE = H 

WRITE “REGISTER VALUE TAG’ 


— 8087 Debugging Support 


WRITE ‘-------- (hi) ese (1o) ~~! 
-?Z1 = O.| | ;USED FOR PASSING VALUE TO MACRO TAG AND FOR LOCAL COUNTER 
COUNT 8T 38 - 80 BIT STACK REGISTERS IN 8087 


TAG Z420,(.?Z1) 3;PASSES BACK .?24 

02722 = .?7Z1*10T } | 

WRITE “STC’,.7Z1,%) “, BYTE Z40+.7Z2+37T,” “,& 
BYTE 4O+.2?Z2+36T,’ °, BYTE 4O+.?Z24+35T,’ °,& | 
BYTE 40+.7Z2+34T,° °, BYTE 20+.7Z224+33T,’ °,& 
BYTE 40+.2?7Z2+32T,’ °, BYTE 40+.?7Z2+31T,’ °,& 
BYTE 420+.27Z2+30T,° °, BYTE 40+.7Z2+29T,’ °,& 


BYTE %0+.?Z2+28T, ’ We £904 
.7Z1 = .27Z14+1 
END 
EM 


e 


S KKKRKEKKEKRRKEKKREKREKEKRRRRERKEKEKRKKKEKKKKKEKKEKKEK 


> 
DEFINE MACRO EVALSTK 
DISABLE EXPANSION 


WRITE ‘REGISTER | VALUE TAG‘ 

WRITE $-------- 2 2 w= ---' 

721 = 0 ;USED FOR PASSING VALUE TO MACRO TAG AND FOR LOCAL COUNTER 
COUNT 8T ;ONCE FOR EACH STACK ELEMENT 


:TAG 40,.-?Z1 3;PASSES BACK .?24 
(02722 = (404+(.27Z1*10T)+28T) 


IF .?Z24 = 0 THEN -TEST TAG 

WRITE ’ST(’,.?Z1,°) ’,TREAL .?2Z2,’ VALID’ 

ORIF .?24 = 1 THEN 

WRITE ’ST(’,.?Z1,°) eSTREAL P22." ZERO’ 

ORIF .?Z4 = 2T THEN 

WRITE ’ST(’,.?2Z1,”) ’ -TREAL “<< ?Z22,% NaN/INFINITE/DENORMAL ’ 
ORIF .?24 = 3T THEN | 

WRITE ’ST(’,.?Z1,”) ’,TREAL 22722,’ FREE’ 

ENDIF sALL POSSIBLE TAG VALUES COVERED 
~?7Z1 = .2?Z1 + 1 | 

END 

EM 


> 
s RRKKKKRAKKKEKEKEKKERKEKRKERERKRKEKKREKEEERRKKRKEEKK 


’ 

DEFINE MACRO EVALSTAT 

DISABLE EXPANSION 

sEVALCW % 

:EVALSW ZO 

EM 

CRIS C GIGI TORI OGG IGIGIGIOIGI GOGO OIGICI GOGO IOI IOOI SII ITOH 


b 

DEFINE MACRO EVALCW 
DISABLE EXPANSION 

WRITE “CONTROL WORD: ’ 

IF (CWORD %04+14T)/4K) THEN 
WRITE ° CLOSURE = AFFINE’ 


ELSE | 

WRITE ’ CLOSURE = PROJECTIVE’ 
ENDIF | 

2221 = (CCWORD %40+14T)/1K) AND O31) 
IF .?Z21 = 0 THEN ) 

WRITE ”° ROUNDING = NEAREST/EVEN’ 


ORIF .?Z1 = 1 THEN 

WRITE ’ ROUNDING = DOWN’ 

ORIF .?Z1 = 2 THEN 

WRITE * ROUNDING = UP’ 

ORIF .?Z21 = 3 THEN | , 

WRITE ”% ROUNDING = TRUNCATE’ 

ENDIF | 

~7Z1 = (CCWORD %0+14T)/256T) AND 03H) 
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IF .?71 = 0 THEN 

WRITE % SINGLE PRECISION’ 
ORIF .?Z21 = 2 THEN 

WRITE ° DOUBLE PRECISION’ 
ORIF .?7Z1 = 3 THEN 

WRITE ° TEMPORARY PRECISION’ 
ENDIF 

WRITE ’ MASK = ’,BOOLC(C WORD %40+14T)/128T) 
WRITE % MASK BITS SET:’ 

©?Z1 = (WORD Z%0+14T) 

IF .?21/32T THEN 


WRITE ’ PRECISION ERROR’ 
ENDIF 

IF .?Z1/16T THEN 

WRITE ” UNDERFLOW ERROR’ 
ENDIF 

IF .?21/8T THEN 

WRITE ”’ OVERFLOW ERROR’ 

ENDIF 

IF .2?21/4T THEN 

WRITE ’ DIVIDE BY ZERO ERROR’ 
ENDIF 

IF .?Z1/2T THEN 

WRITE ’ DENORMALIZATION ERROR’ 
ENDIF 

IF .?Z1 THEN 

WRITE ” INVALID ERROR’ 

ENDIF 


EM. 


’ 
BARR KKKKEK KKK KEKE RK RE KKEKKEEREKERKEKKREKRKERRRERERKERKRERKRKERKKRAKEREKERKKREKKEKKEEKKKE 


2 

DEFINE MACRO EVALSW 
DISABLE EXPANSION 
WRITE ’STATUS WORD: ’ 
°?Z1 = (WORD Z40+16T) 


WRITE BUSY = ’,BOOL(.2?721/32K) 

WRITE % COCZERO) = %,BOOL(.?Z1/16K) ;CONDITION CONE BIT 14 
WRITE ’° TOP = REGISTER °,(.?Z1/2K) AND O7H 

WRITE “ C2 = %,BOOL(.?771/1K) ;CONDITION CODE BIT 10 
WRITE % Cl = ’,BOOL(.721/512T) ;CONDITION CODE BIT 9 


WRITE % COCSIGN) = %,(.7Z21/256T) AND O1H ;CONDITION CODE BIT 8 
WRITE ° INTERRUPT = %,BOOL(.?21/128T) 

WRITE ° ERROR FLAGS SET:’ 

IF (.?Z21/32T) THEN 


WRITE “ PRECISION ERROR’ 
ENDIF 

IF €.?Z1/16T) THEN 

WRITE ’ UNDERFLOW ERROR’ 
ENDIF 

IF (.7Z21/8T) THEN 

WRITE ’ OVERFLOW ERROR’ 

ENDIF 

IF (€.221/4T) THEN 

WRITE ’ DIVIDE BY ZERO ERROR’ 
ENDIF 

IF (.721/2T) THEN 

WRITE “ DENORMALIZATION ERROR’ 
ENDIF : 

IF (.?Z1) THEN 

WRITE ’ INVALID ERROR’ 

END 

EM 


’ | 
y RRKRKKKKKEKAEKKKRKRRKKEEKERKKEKEKEREKKEKEREREKEEKK 


; | 
DEFINE MACRO CW 
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WORD (Z0+14T) 241 
EM 


9 
s MAK KRKKKKKEKRKKRKKEKREKEKEKEKEKEKKEEKKEKEEKKEKEKEKK 


DEFINE MACRO SW 
WORD (40+16T) 41 
EM 


9 
s RRERKHKKRREKEKRKEKERKEKKKEREKKEKREKEKEKEKKEKERKEKKKKE 


> 

DEFINE MACRO TW 
WORD (40+18T) 241 
EM 


s RAKAKHEKKKKKEKEREKEKKEKKKEAEKKEKKKEKRKKKEKKKKKKEKK 


9 

DEFINE MACRO STK 

DISABLE EXPANSION 

TRE (ZO0+28T+Z4Z1*10T) 42 

EM 

CAO ICCC CIC CITC CCITT IO III k 


> 

DEFINE MACRO STKADDR 

DISABLE EXPANSION 

IF 41 > 7T THEN 

WRITE “STACK OFFSET TOO LARGE’ 
ELSE 

EVALUATE 420+28T+Z1*10T 

ENDIF 

EM 


» 
g RHR KKKKEEKRKEKKRKKKKKE ERE KHER RKEKKREREKEREEKREKREKKEKKEKKEK 


9 
DEFINE MACRO TAG ;TAG IS USED INTERNALLY 
©?23 = 1 | 
COUNT ((( (WORD %0+16T)/2K) AND 0O7H)+%1) MOD 8T 
22723 = (.723)*4T 
END 
02724 = (CWORD %04+18T)/(.?23)) AND O30 | 
;IT IS REQUIRED BECAUSE THF TAG WORD IS NOT IN THE SAME ORDER (STACK 
sRELATIVE) AS THE STACK REGISTER FILE. IT PLACES THE SELECTED TAG INTO 
sBYTE 5 OF THE STATUS BLOCK. THE TAG IS COMPUTED THUS: 
TOP <- (status word/2K) AND O74 
INDEX <- (TOP + offset_select) MOD 8 
TAG <- (tag word/(4**INDEX)) AND 03H 
M 


e [Xj] we we we 


5) 
gs RA KKKKRERKKKEKK KEK EKER EK KEK EKER KRKRKKKREKKEEEKKKE 
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APPENDIX J 
REFERENCE SCHEMATICS 


This appendix contains the following schematic drawings, for user reference: 


TITLE NUMBER 
86 Controller Schematic (12 sheets) .............. 00.00.0000 0c eee 162411 
FM Controller Schematic (8 sheets) .... ey eee ee 162416 
ICE 86/88 Trace Schematic (10 sheets) .....................00005 162485 
Buffer Board 1 Schematic (8 sheets) .............. 00... 0..0 cee 123022 
Buffer Board 2 Schematic (8 sheets) ...................... eee ee 123025 
NOTE 


The documents in this appendix are for general reference only. 
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